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PREFACE 


This manual describes the Perkin-Elmer Common Assembly 
Language/32 (CAL/32). Chapter 1 is an introduction to the basic 
concepts of the assembler, central processing unit (CPU), and 
main memory. Also described are the instruction formats for 16- 
and 32-bit machines, as well as variations in the formats. 
Chapter 2 introduces assembly language symbolic representation 
and describes symbolic values. Chapter 3 defines the source 
program and contains a list of machine instructions, mnemonics, 
and a detailed description of assembler instructions. Common 
mode programming and common mode operations are explained in 
Chapter 4. CAL /32 a instructions are Listed in Chapter 
Bu 


Appendix A contains CAL/32 error codes. Appendix B describes the 
Perkin-Elmer 32-bit object code format and the Perkin-Elmer 
16-bit object code format. 


This revision introduces the Perkin-Elmer Model 3200MPS 
Multiprocessing System and outlines the arrangement of the CPU 
and auxiliary processing units (APUs). The CAL/32 machine 
instructions that are incompatible between the CPU and the APU of 
a multiprocessing system and those that cannot be used on the APU 
are specified. 


This manual is intended for use with the OS/32 R0O7.1 software 
release and higher. The Model 3200MPS System features are 
identified throughout the manual as applicable to the Model 
3200MPS System only. 


For information on the contents of all Perkin-Flmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
BASIC CONCEPTS 


1.1 INTRODUCTION 


Like all assemblers, Common Assembly Language/32 (CAL /32) 
simplifies the direct control of the processor by providing the 
programmer with a way of representing actual machine operations 
in an easily understood symbolic form. Assemblers translate 
symbolic representations of machine instructions into binary form 
to be executed by the processor. CAL/32 also includes’~ such 
features as relocation, segmentation, complex data definitions, 
and expression analysis. CAL/32 can run on any Perkin-Elmer 
processor and produce machine code for any Perkin-Elmer 
processor. 


Because assembly language programming is so close to actual 
machine operations, it is essential that the assembly language 
programmer have a good understanding of system architecture. 
This chapter contains introductory architectural descriptions for 
Perkin-Elmer uniprocessing systems and multiprocessing systems. 
See the appropriate processor manual for more detailed 
information. 


1.2 THE PERKIN-ELMER PROCESSOR 


The main components of a processor are the central processing 
unit (CPU) and main memory. All Perkin-Elmer processors, whether 
in a uniprocessing or a multiprocessing system, are 
stored-program, multi-register, two-address machines. 


There are three iterations of the ptocessor within Perkin-Elmer 


computers: 


e A standard processor for a Perkin-Elmer uniprocessing system. 
Figure 1-1 depicts the conf iguration of a typical 
uniprocessing system. | 


e A CPU in a multiprocessing system. 
e Up to nine auxiliary processing units (APUs ) in a 


multiprocessing system. Figure 1-2 depicts the configuration 
of a typical multiprocessing system. 
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Figure 1-1 Configuration of a Typical Uniprocessing System 
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Figure 1-2 Configuration of a Typical Multiprocessing System 
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In addition to the standard tasks performed by the operating 
system in a uniprocessing system, the operating system in a 
multiprocessing system: 


@e Controls all APUs 
® Monitors all activity in the multiprocessing system 
@e Services all APU exceptions 


@ Dispatches application tasks created for existing CPUs or the 
CPU of a Model 3200MPS System 


e Dispatches tasks to the APUs for execution in a Model 3200MPS 
System. 


The function of an APU is to execute tasks concurrently with the 
CPU and other APUs. 


1.2.1 Temporary Storage (Registers) 


All Perkin-Elmer processors have some amount of temporary storage 
that can be used as accumulators or index registers. There are 
three types of temporary storage: 


@ General purpose registers 
@e Single precision floating point registers 


e Double precision floating point registers 


All processors have at least one set of 16 general purpose 
registers. In the 16-bit processors, each general purpose 
register holds 16 bits; the 32-bit processors hold 32 bits. 
General purpose registers can be used for integer arithmetic, 
address arithmetic, logical operations, and character operations. 


Floating point registers are used only for floating point 
arithmetic operations. Processors with floating point registers 
have either eight single precision registers, or eight single 
precision registers and eight double precision registers. The 
single precision registers hold 32 bits. The double precision 
registers hold 64 bits. 


For a multiprocessing system, there are up to ten sets of these 
registers; one for each of the nine APUs that can be part of the 
system, plus a set in the CPU; i.e., ten machines each have eight 
general register sets, eight single precision floating point 
registers, and eight double precision floating point registers. 
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1.2.2 Program Status Word (PSW) 


The PSW defines the current state of a processing unit. The 
Perkin-Elmer uniprocessing system has one current PSW. Since the 
Model 3200MPS System consists of multiple processors, there is 
one current PSW for each processor. The PSW consists of three 
major parts: 


e Status descriptor 
e Condition code 


@ Location counter (LOC) 


Individual bits and bit fields within the status descriptor 
portion of the PSW define the current state of interrupts and 
various hardware features of the processor. By setting or 
resetting bits within the status descriptor, the programmer can 
enable or disable such interrupts as. input/output (I/O), 
arithmetic fault, and machine malfunction. On those processors 
with multiple sets of general purpose registers, a field in the 
status descriptor defines which set is currently in use. 
Programmers writing user-level programs, as opposed to operating 
system or stand-alone programs, cannot directly access the status 
descriptor. In this case, the operating system maintains control 
of interrupts and registers. 


The condition code provides a means of controlling program flow, 
based on the results of instruction execution. As certain 
instructions are executed, the value in the condition code 
changes to indicate the nature of the result. For example, if an 
operation produces a zero result, the condition code may be 
changed to a zero value. With branch instructions, the 
programmer can test the value in the condition code and branch or 
not, depending on that value. Not all instruction executions 
affect the condition code. See the appropriate processor 
reference manual for more details. 


The LOC controls the order of instruction execution. Normally, 
the processor executes instructions sequentially and uses the LOC 
to keep track of where the instructions are in main memory, then 
fetches the instruction from the memory location specified by the 
address contained in the LOC. It executes that instruction, 
increments the LOC by the length of the instruction, and fetches 
the next instruction. Branch instructions, when executed, change 
the contents of the LOC and, thereby, affect the branch. 


In 32-bit machines, the PSW contains 64 bits, the least 
significant 24 of which are reserved for the LOC. In 16-bit 
machines, the PSW contains 32 bits; the least significant 16 bits 
are reserved for the LOC. 
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1.2.3 Input Output (1/0) Interface 


The execution of certain machine instructions allows the 
programmer to control external devices and to cause the transfer 
of data between external devices and main memory or registers. 
The actual programming of I/O operations is very much dependent 
upon the hardware of both the processor and the peripherals. 1/0 
instructions are restricted to operating systems and stand-alone 
programs. User programs can communicate with I/O devices through 
facilities provided by the operating system. 


1.2.3.1 Main Memory 


To the assembly language programmer, main memory appears as a 
block of contiguous storage locations. The smallest unit of 
memory the programmer can access is the byte (eight bits). The 
programmer can also access halfwords (two bytes), fullwords (four 
bytes), and doublewords (eight bytes). Each byte in memory is 
accessed by a unique address. Memory addresses start with zero 
and are incremented by one, for each succeeding byte. Memory 
addresses in the 32-bit processors always consist of 24 bits. In 
the 16-bit processors, memory addresses consist of 16 bits. When 
accessing bytes, any memory address within the limits of the 
particular hardware configuration is considered valid. Halfwords 
must be accessed with halfword addresses. Fullwords must be 
accessed with addresses that are multiples of four. Doublewords 
must be accessed with addresses that are multiples of eight. 


1.2.4 Software Relocation 


Programs written in CAL/32 can be absolute or relocatable. An 
absolute program is one whose origin (starting location) is 
specified at assembly time as being at a fixed halfword location 
in memory. Subsequent addresses within the program, whether 
referring to instructions or data, are fixed at assembly time. 
For execution, absolute programs must always be loaded into 
memory at the location specified as the origin. This type of 
programming is useful in stand-alone applications and some 
operating system situations. 


Relocatable programs can be loaded for execution beginning at any 
halfword location in memory. The origin of a relocatable program 
is assumed to be relocatable zero. The CAL/32 output for this 
type of program specifies all addresses in the program as 
relative displacements from the origin. At link time, the 
linkage editor resolves all addresses within the program by 
adding a relocation value (the actual memory address for the 
start of the program) to the relative addresses supplied by 
CAL/32. Relocation applies only to addresses within the program. 
Relocatable programs can contain absolute data. 
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1.2.5 Hardware Relocation 


Some Perkin-Elmer processors and their operating systems support 
hardware relocation and segmentation. Programs prepared for 
these systems start out as relocatable. A linkage editor 
processes the relocatable output from CAL/32 to link in any 
needed subprograms. The output of this process is an absolute 
program that, because of the relocating hardware, can be loaded 
beginning at any memory address that is a multiple of 256 for 
memory access controller (MAC) machines, or 2,048 for memory 
address translator (MAT) machines. At run time, the relocating 
hardware adds the required relocation value to all addresses 
supplied by the program. This relocating hardware also provides 
for program segmentation, where the program is divided into 
pieces that can be loaded into noncontiguous blocks of memory. 


CAL/32 supports segmentation by allowing the programmer to divide 


the program into pure and impure segments. The pure segment of 
a program consists of machine instructions and constant data and 
cannot be modified at run-time. (The operating system and_ the 
hardware prevent modification.) The impure segment consists of 
the data base which can be modified at run-time. Programs 
prepared as pure and impure segments can be shared (executed 
concurrently) by several users. Only one copy of the _ pure 


segment resides in memory during execution while there is one 
copy of the impure segment for each user. 


1.3 INSTRUCTION FORMATS (16-BIT) 


The 16-bit processors have four types of machine instructions: 
register to register (RR), register and indexed storage (RX), 
register and immediate (RI), and short form (SF). The following 
abbreviations illustrate the instruction formats: 


OP Operation 
R1L First operand register 
R2 Second operand register 


N A 4-bit immediate value 
X2 Second operand index register 
A2 Second operand direct address 


I2 Second operand immediate value 


Most instructions require two operands, the first of which is 
contained in ae register. The result usually replaces’ the 
contents of the first operand register. Exceptions to these 
rules are noted in Section 1.5. 


1.3.1 Register to Register (RR) Instructions 
RR instructions cause operations to take place between operands 


contained in registers. RR instructions are 16 bits long, as 
shown in Figure 1-3. 
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FEED Te Joe aen ee, Gane. Ngee | Bay |e 
H OP H R1 H R2 { 
eG RG Gm mn RI RG Gm nn GF FG HH 
Bits: 

0 7 8 LL 12 15 


Figure 1-3 RR Format (16-Bit) 


The first eight. bits of the instruction define the operation. 
The next four bits identify the first operand register. The 
final four bits identify the second operand register. In most RR 
instructions, the specified operation takes place between the 
contents of the first operand register and the contents of the 
second operand register. The result of the operation replaces 
the contents of the first operand register. 


1.3.2 Register and Indexed Storage (RX) Instructions 
RX instructions cause an operation to take place between a first 
operand, contained ina register, and a second operand, located 


in main memory. These instructions require 32 bits, as shown in 
Figure l]-4. 


<i F GG Har GB GHG HG GRR GF HH 


{ OP H R1L | X2 | A2 { 
mF GaG Gem mmn OS GS. Gee SG. EG. Gee aes 
Bits: , 
0 7 8 11 12 15 16 31 


Figure 1-4 RX Format (16-Bit) 


t 


The first eight bits define the operation. The next four bits 


identify the first operand register, and the next four bits 
identify an optional index register. The remaining 16 bits 
specify an address in main memory. The operation takes’ place 


between the contents of the first operand register and the 
contents of the memory location specified. The actual address of 
the second operand is determined by adding the contents of the 
index register to the contents of the address field. If the 
index field of the instruction contains zero, no indexing takes 
place. In most cases, the result of the operation replaces the 
contents of the first operand register. 
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1.3.3 Register and Immediate (RI) Instructions 


These instructions cause operations to 


take place between the 


contents of a register and the contents of an immediate field 
imbedded in the instruction itself. They are 32 bits long, and 
are shown in Figure 1-5. . 

S25 Go ea B Gaegs [Gere ee Gone. Gee aia > ae 

H OP R1 H X2 ; I2 

~--$ $4 $----- $ FB G---$ HH GHG GH 

Bits 

0 7 8 11 12 15 16 31 
Figure 1-5 RI Format (16-Bit) 


The first 
an optional index register. 
value. The first 
register. 


the index field contains 
result of the operation usually 
first operand register. 


eight bits specify the operation. 
identify the first operand register. ' 
The final 16 bits are the 
operand is the contents of the first operand 
The second operand is obtained by adding the 
of the index register to the contents of the immediate field. 
zero, 


The next four bits 
The next four bits identify 
immediate 


contents 


If 
no addition takes place. The 
replaces the contents of the 


1.3.4 Short Form (SF) Instructions 


These instructions are variations on the RI instructions in which 


the second operand is small enough to be expressed in four 


SF instructions require 16 bits, 


side Aa ar ae Acca ne Z 
OP 
fog eo: eee 
Bits: 

0 7 8 


Figure 1-6 SF 


The 


the immediate value. 
of the first operand register. 
usually replaces the contents of 


first eight bits indicate the operation. 
identify the first operand register. 


bits. 
as shown in Figure 1-6. 


$4 $---5 95 H-- 
Rl {| N | 
G4 $---$ 56 &H- 


ll 12 15 


Format (16-Bit) 


The next four bits 
The next four bits contain 


Operations take place between the contents 


The result of the operation 
the first operand register. 
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1.4 INSTRUCTION FORMATS (32-BIT) 


The 32-bit processors recognize seven different types of 
instructions. These are: RR, three variations on RX, two 
variations on RI, and SF. The following abbreviations are used 
to illustrate instruction formats: 


OP Operation 

R1 First operand register 

R2 Second operand register 

N A 4-bit immediate value 

X2 Second operand single index register 
D2 Second operand displacement 


FX2 Second operand first index register 
SX2 Second operand second index register 
A2 Second operand direct address 

I2 Second operand immediate value 


Most instructions require two operands, of which the first is the 
contents of a register. The result of the operation usually 
replaces the contents of the first operand register. Exceptions 
to these rules are noted in Section 1.5. 


1.4.1 Register to Register (RR) Instructions 


The format and function of these instructions are the same as for 
the 16-bit processors. They cause operations to take place 
between operands contained in registers, and they require 16 
bits. These instructions are shown in Figure 1-7. 


Se: Pe Bae $5 $n---$ F4H-- 
H OP { R1 H R2 | 
Gepoeue § 5 § ale § >- 4 S- esate S 6- ~4 5 
Bits 

0 7 8 p 2b t2 15 


Figure 1-7 RR Format (32-Bit) 


The first eight bits specify the operation. The next four bits 
identify the first operand register, and the last four bits 
identify the second operand register. The processor performs the 
indicated operation between the contents of the first’ operand 
register and the contents of the second operand register. In 
most RR instructions, the result replaces the contents of the 
first operand register. 
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1.4.2 Register and Indexed Storage One (RX1) Instructions 


These instructions define an operation between the contents of a 
register and the contents of a main memory location. They 
require 32 bits, as shown in Figure 1-8. 


Say Sl OR ce a Do Gee. Ge, ee: um aes Soa tale 4 es 
{ OP H Rl H X2 | O } O ff A2 i 
ae SARE ait ae a ae cates a Oe er a A ae 
Bits: 

0 7 8 ed. 2 15 16 17 18 31 


Figure 1-8 RX1l Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register, and the next four bits 
identify the index register. The next two bits, bits 16 and 17, 
must be zeros. The next 14 bits constitute a direct program 
address ina range from 0 to 16,383. 


The address of the second operand is obtained by adding the 
contents of the index register to the contents of the 14-bit 
address field. If the index register field contains zero, this 
addition does not take place, and the contents of the address 
field are used as the address. The operation takes place between 
the contents of the first operand register and the contents of 
the specified memory location. The result usually replaces the 
contents of the first operand register. 


1.4.3 Register and Indexed Storage) Two (RX2) Instructions 


These instructions define operations between the contents of a 
register and the contents of a location in main memory. RX2 
instructions are like the RX1l instructions; they require 32 bits. 
They differ from the RX1l instructions in the method of 
calculating the second operand address. See Figure 1-9. 


SER G PRS ee Ye ate os eters) eos 
H OP H R1 ' X2 i L } D2 H 
Sapa ak ane a ae eet a ae $$  &H- 
Bits: 

0 7 8 ll 12 15 16 17 31 


Figure 1-9 RX2 Format (32-Bit) 
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The first eight bits define the operation. The next four bits 
identify the first operand register, and the next four § bits 
identify the index register. The next bit, bit 16, must be a 
one. The remaining 15 bits are treated as a signed integer in 
two's complement notation. Bit 17 is the sign bit which, if one, 
indicates a negative quantity, and if zero, indicates a positive 
quantity. 


The address of the second operand is obtained in two steps. 

1. The signed integer, with sign bit extended to produce a 
32-bit integer, is added to the contents of the index 
register. 

2. This intermediate result is added to the value in the 


incremented LOC. The result is truncated to 24 bits. 


If the index register field is zero, the first addition does not 


take place. The indicated operation takes place between the 
contents of the first operand register and the contents of the 
specified memory location. The result usually replaces the 


contents of the first operand register. 


1.4.4 Register and Indexed Storage Three (RX3) Instructions 


These instructions are analogous to the RX instructions in the 
16-bit processors. They call for operations between the contents 
of a register and the contents of an indexed memory location and 
require 48 bits. See Figure 1-10. 


Sia 2k 5 diac dik ate 2 anette avear TA anaieteaptetaeerira eae 4-4 $---4 $4 GH 
} OP | Rl | FX2 ioj}lfo}o ; SX2 i A2 
---4 4-4 OG G—--4 HG Gon nnn nnn nnn nnn nee 4 $-4 FR--5 HH S- 
Bits: 

0 7 8 11 12 15 16 17 18 19 20 23 24 31 


y 
Figure 1-10 RX3 Format (32-Bit) 


The first eight bits specify the operation. The next four bits 
identify the first operand register, and the next four bits 
identify the first index register. Bit 16 must be zero. Bit 17 
must be one. Bits 18 and 19 must be zero. The next four bits 


identify the second index register. The next 24 bits contain a | 


direct memory address. 
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The address of the second operand is obtained by adding the 
contents of the first index register to the contents of the 
second index register. This intermediate result is then added to 
the contents of the direct address field, and the final result is 
truncated to 24 bits. . 


If either of the index register fields contains zero, that level 
of indexing does not take place. If both are zero, no indexing 
takes place. In most RX3 instructions, the operation takes place 
between the contents of the first operand register and _ the 
contents of the specified memory location. The result usually 
replaces the contents of the first operand register. 


1.4.5 Register and Immediate One (RI1) Instructions 


These instructions are similar to the RI instructions in the 
16-bit processors. They specify operations that take place 
between the contents of a register and the contents of a field 
that is part of the instruction. They require 32 bits, as shown 
in Figure 1-1l. , 


ae ee a aera GES GSAS EG GAS GS 
OP RL X2 12 
Se Beers PEGE ee Gee Pg ge 
Bits: 

0 7 8 11 12 15 16 31 


Figure 1-1l RI1 Format (32-Bit) 


The first eight bits indicate the operation. The next four bits 
identify the first operand register, and tthe next four bits 
identify an index register. The second operand is obtained by 
extending the contents of the immediate field to 32 bits, by 
propagating the sign bit, and then adding this quantity to the 
contents of the index register. If the index register field is 
zero, no addition takes place, and the extended immediate value 
is the second operand. The operation takes place between the 
contents of the first operand register and the immediate value. 
The result usually replaces the contents of the first operand 
register. 


1.4.6 Register and Immediate Two (RI2) Instructions 
These instructions are similar to the RI1l instructions, except 


that the field contains a 32-bit value, and the instruction 
itself requires 48 bits. See Figure 1-12. 
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etait a i ate Tt aaa a amen 2 ain aan ec oe 

OP R1 H X2 I2 

Si) oe Ger ere se Saree: “orno Grae Sam ea 
Bits: 

0 7 8 ll 12 15 16 31 


Figure 1-12 RI2 Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits identify 
the index register. The second operand is obtained by adding the 
contents of the index register to the contents of the immediate 
field. If the index register field is zero, no addition takes 
place, and the immediate value is the second operand. The 
operation takes place between the contents of the first operand 
register and the immediate value. The result usually replaces 
the contents of the first operand register. 


1.4.7 Short Form (SF) Instructions 


SF instructions are similar to the SF instructions in the 16-bit 


processors. They specify operations between the contents of a 
register and the contents of an immediate field, whose value is 
small enough to be expressed in four bits. These instructions 


require 16 bits, as shown in Figure 1-13. 


ae ey aaa a a aie A ce 
} OP 4 R1 H N i 
meh GG mmm KG GH GRR KG FG OH 
Bits: 

0 7 8 Li 12 L5 


} 
t) 


Figure 1-13 SF Format (32-Bit) 


The first eight bits define the operation. The next four bits 
identify the first operand register. The next four bits are the 
immediate field. The operation then takes place between this 
value and the contents of the first operand register. The result 
usually replaces the contents of the first operand register. 
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1.4.8 Register and Indexed Storage/Register and Indexed Storage 
(RXRX) Instructions 


RXRX instructions resemble a pair of adjacent RX instructions, 
but represent one cohesive string-processing instruction. An 
RXRX instruction is comprised of two instruction members. Each 
member can be any one of the RX1, RX2, or RX3 machine formats, 
independent of the other member's format. For example, the first 
instruction member might be of the RX1 format, and the second 
instruction member might be of the RX3 format, yielding a 10-byte 
RXRX instruction. Thus, an RXRX instruction length might range 
from 8, 10, or 12 bytes. 


The first eight bits of the first instruction member, OP, specify 
the operation class. The particular RXRX operation is specified 
by the contents of the operation-modifier (OP-MOD) field in the 
first eight bits of the second instruction member. OP-MOD is 
actually generated by the assembler according to the specific 
RXRX operation mnemonic and the R1/L1l or R2/L2 fields programmed 
by the user in source code. See Figure 1-14. 


5381 


FIRST MEMBER SECOND MEMBER 
4 TQ 6 BYTES 4T0 6 BYTES 
31/47 
5— 
0 | 12-15 16 17 310123 7 12-16 16--1920-23 24 erat ay 
RX1/RX2 SAMPLE MEMBER RX3 SAMPLE MEMBER 
+ - . —> 


8, 10, 12 BYTES 


Figure 1-14 RXRX Format (32-Bit) 


The next four bits in the first instruction member, R1/L1, 
identify either Rl, the string's length-specifying register, or 
Ll, the string's actual length. The user specifies to the 
assembler whether the value in the R1/L1l field is a register or 
an immediate value. 
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The R1/L1 field is assumed to be a register, unless an equal sign 
(=) precedes the Ll source expression. In machine format, the 
ILl field is set when the =-L1 source field specifies an immediate 
value as length. The IL2 field in machine format is reset when 
the Rl field is used to specify a register that contains’ the 
string's length. When the length is an immediate value, its 
value may range from O through 15. When the length is in a 
register, the register may contain a length that ranges from 0 
through 224-1. A length of O indicates a null string. 


The remaining bits, bits 12 through 31 or 12 through 47, of the 
first instruction member, OPN1, contain the address/location of 
the lowest addressable byte of a string or its storage location. 
The field, OPN1, is then similar to the indexed address portion 
of an RX1, RX2, or RX3 machine format. See OPN2 below. 


The first eight bits of the second instruction member, OP-MOD, 
are an operation-modif ier field containing OPNI1's’~ length 
indicator, I[L1, in bit 0; OPN2's length indicator, IL2, in bit 1; 
a special circumstances bit, C, in bit 2; and in bits 3 through 
7, FUNC, the specific function code of the general operation 
class, OP. As described above, II.l and IL2 are determined by the 
assembler. The special circumstance: bit, C, and function code, 
FUNC, are determined by he assembler from the 
operation-mnemonic. The C bit is used by some RXRX instructions 
to indicate that the result of the operation will be forced 
positive. 


The next four bits, bits 8 through 11, of the second instruction 
member , R2/L2, identify either R2, this string's 
length-specifying register; or L2, the string's actual length. 
Again, the user specifies in source format to the assembler 
whether the value in the R2/L2 field is a register or an 
immediate value. The R2/L2 source format field is assumed to be 
a register, unless an equal sign (=) precedes the L2_ source 
expression. In machine format, [L2 is set when the =L2 field is 
used to specify an immediate value. IL2 is reset when R2 is used 
to specify a register. When the length is an immediate value, 
expressed as -L2, its value may range from 0 through 15. When 
the length is ina register, its value.may range from 0 - through 
224-1. A zero length indicates a null string. 


The remaining bits, bits 12 through 31 or 12 through 47, of the 
second instruction member, OPN2, contain the address/location of 
the lowest addressable byte of a second member's string. Both 
OPN1l and OPN2 are similar in format to the indexed address 
portion of an RX1l, RX2, or RX3 machine’ format. The particular 
format of either OPN1 or OPN2 is selectively generated by the 
assembler, independently according to the user source program. 


In RX1 machine format, bits 16 and 17 are zero. Bits 12 through 
15 identify the index register, X2, the contents of which are 
added to the absolute 14-bit value, D, to formulate the string's 
address. 
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In RX2 machine format, bit 16 is set. Bits 12 through 15 
identify the index register, X2, the contents of which are added 
to the 15-bit displacement value, D2, to formulate the string's 
address. 


In RX3 machine format, bits 16 through 19 are 0100 binary. Bits 
12 through 15 identify the first index register, FX2; and bits 20 
through 23 identify the second index register, SX2. The contents 
of both are added to the 24-bit address value, A, to formulate 
the string's address. 


NOTES 


l. When the first member's OPN1 
represents the string's address in 
RX2 format, the displacement value, 
D2, is relative to the end address of 
the first instruction member, not to 
the end of the full RXRX ‘instruction. 


Z2. When the second member's OPN2 
represents the string's address in 
RX2 format, the displacement value is 
relative to the end of the_ second 
instruction member, which is also the 
end of the full RXRX instruction. 


1.5 VARIATIONS ON INSTRUCTION FORMATS 


Not all instructions follow the above instruction formats. In 
some instructions the fields are redefined. Some instructions do 
not require two operands. Some instructions do not change the 
first operand, some instructions change the second operand, and 
some instructions change neither operand. 


1.5.1 Conditional Branch Instructions 


Conditional branch instructions use formats that resemble RR, RX, 
and SF instructions. However, the interpretation of the fields 
differs from the standard, as does the actual operation. In all 
conditional branch instructions, the first operand identification 
is interpreted as a mask that is ANDed with the condition code. 
If the result of this test indicates that the branch is to be 
taken, then the second operand address is the location to which 
the processor must go to obtain the next instruction. 


In the RR instructions, the second operand register contains’ the 


branch address. In the RX instructions, the branch address is 
obtained by one of the standard methods for obtaining second 
operand addresses. In the SF instructions, the immediate field 


is interpreted as a halfword displacement, either forward or 
backward, from the current LOC. The branch address is obtained 
by adding or subtracting this quantity from the current LOC. 
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{ 
1.5.2 Branch and Link Instructions 


These instructions facilitate branching to and returning from 
subroutines. They use formats similar to RR and RX where the 
first operand register is the link register. Before the branch 
is taken, the address of the next memory location following the 


branch instruction is placed in this’ register. In the RR 
instructions, the branch location is the contents of the second 
operand register. In the RX instruction, the branch address. is 


obtained by one of the usual methods for obtaining second operand 
addresses. 


1.5.3 Other Variations 


Some instructions change the second operand rather than _ the 
first. Most notable among these are the store instructions and 
the instructions that add the contents of a register to the 
contents of a memory location. 


Test instructions sa compare instructions change neither 
operand. The indicated operation takes place between the two 
operands, but neither is changed. The result of the operation is 
indicated by the condition code. 


Certain other instructions, such as load PSW and simulate 
interrupt, do not always require a first operand. In addition, 
all of the [/O instructions do not follow the general rules. For 
detailed information on how these and other anomalous 
instructions work, see the appropriate processor reference 
manual. 
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CHAPTER 2 
SYMBOLIC REPRESENTATION 


2.1 INTRODUCTION 


When writing assembly language programs, the programmer’ uses 
meaningful symbols to represent the binary language interpreted 
by both Common Assembly Language/32 (CAL/32) and the processor. 
Symbols consist of printable ASCII characters, either singly or 
in combination. CAL/32 recognizes the complete set of printable 
ASCII characters. However, depending on the context, there can 
be restrictions on the use of the complete set. See Chapter 3. 


2.2 SYMBOLS AND EXPRESSIONS 

\ 
Symbols represent addresses, register identifiers, absolute 
values, operation identifiers, and constants. Examples of 
symbols are: 


16 


Symbols can be combined to form expressions. The arithmetic 
operators: add, subtract, multiply, and divide are represented 
in CAL/32 by the symbols: +, -, *, and /. They combine with 
other symbols to form arithmetic expressions. Examples of these 


arithmetic expressions are: 


A+B 
LAST-F IRST* TWO 
A-16 


Blanks and parentheses are not permitted within an expression. 
For example, the sequence: 


A-B* (C + D) 


would not be interpreted by CAL/32 as an expression. 
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Depending on the context, CAL/32 might misinterpret the symbols, 
generate incorrect code, and fail to detect the error. Where 
CAL/32 can recognize the error, it generates an error message. 


The evaluation of expressions takes place from left to right with 
no rules of precedence. Thus, CAL/32 evaluates the expression: 


LAST-F [IRST* TWO 


by subtracting the value of FIRST from the value of LAST, and 
multiplying this result by the value of TWO. 


Logical expressions consist of symbols joined by the _ logical 
operators AND and inclusive OR. They are represented in CAL/32 
by the symbols & and !. Examples of logical expressions are: 


XEY!IA 
CHARE&NUL.L 


/ 
Logical expressions are evaluated from left to right with no 
rules of precedence. Blanks and parentheses are not permitted in 
logical expressions. 


Mixed expressions are formed by combining logical and arithmetic 
operators. For example: 


A-B!TWO 


CAL/32 evaluates this expression by first subtracting the value 
of B from the value of A, and then ORing the result with the 
value of two. Mixed expressions are like arithmetic and logical 
expressions in that blanks and parentheses are not allowed, and 
the method of evaluation is from left to right with no rules of 
precedence. 


Symbols represent either absolute or relocatable quantities. At 
assembly time, relocatable quantities have a value equal to their 
displacement from some fixed point within the program, usually 
but not necessarily, the origin or starting location. At load 
time, the relocatable quantity is replaced by an absolute 
quantity whose value is calculated by adding the relocation value 
to the relocatable quantity. Absolute quantities are known to 
the assembler at assembly time and are not changed at load time. 


The operations: multiply, divide, AND, and OR are permitted only 


between absolute data. The plus and minus operators can be’ used 
on mixed data. The results of such operations are: 
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OPERATION ; RESULT 


Absolute + Absolute Absolute 
Absolute - Absolute Absolute 
Relocatable + Relocatable Invalid 
Relocatable - Relocatable Absolute 
Relocatable + Absolute Relocatable 
Relocatable - Absolute Relocatable 
Absolute + Relocatable Relocatable 
Absolute - Relocatable Invalid 


2.3 SYMBOLS AND THEIR VALUES 


By definition, certain symbols used in CAL/32 programming have 
implicit values; that is, the value of the symbol is determined 
by the way in which it is expressed and used. Examples of this 
kind of symbol are the decimal, hexadecimal, and character 
symbols used as operands in instructions. There are also global 
symbols in CAL/32. These symbols have preset values that cannot 
be redefined by the programmer. The programmer can define the 
value of a symbol explicitly by ysing the equate statement. This 
section covers the use of impl}cit and global symbols. Chapter 
3 covers the explicit use and deft inition of symbols. 


2.3.1 Implicit Symbols 


When used in the correct context, a string of decimal digits is 
automatically assigned the actual value of the number represented 
by the string. For example, the expression: 


A+14 


has a value that the assembler determines by adding the quantity 
14 to the value A, which must be defined by some other means. 


CAL/32 also recognizes the implicit value of special character 
strings the programmer uses to represent decimal, hexadecimal, 
and character values. These strings are made up of ae single 
letter that indicates the particular type, followed by a group of 
characters enclosed in apostrophes that represents the value. 
The code characters are: 


CODE 
CHARACTER TYPE 
H Halfword decimal 
*F Fullword decimal 
X Halfword hexadecimal 
Y Fullword hexadecimal 
Cc Character 
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Decimal numbers consist of an optional sign (+ or -) followed by 
decimal digits representing the actual value. Commas are not 
allowed in the representation. Halfword decimal values can be 
represented by from 1 to 5 decimal digits, with a range from 
-32,768 to +32,767. Fullword values can be represented by from 
l1 to 10 decimal digits, with a range from -2,147,483,648 to 
+2,147,483,647. CAL/32 converts these decimal numbers into two's 
complement binary integers. Examples of decimal symbols, with 
their internal representation expressed in hexadecimal notation 
are: 


SYMBOL VALUE 
H*i25* 007D 
H'32765' 7FFD 
H'+32765' 7FFD 

Ht 15" FFF1L 

Pe lZoi23" 0001 EOF3 
F'l' 0000 OOO01 
Bees FFFF FFFE 


Hexadecimal symbols consist of the X or Y¥ type code followed by 
a string of hexadecimal digits enclosed in apostrophes. Halfword 
symbols can use from ane to four digits. Fullword symbols can 
use from one to eight digits. Leading zeros are not’ required, 
and the value is right justified. Examples of hexadecimal 
symbols are: 


SYMBOL VALUE 
X'F! OOOF 
X'D4E' OD4E 
Y¥'O30' 0000 (0030 
Y'A' 0000 OOOA 
y'O' 0000 0000 


Character symbols consist of from one to four ASCII characters 
enclosed in apostrophes and preceded by the type code C. 
Characters are right justified, with zero fill. Depending on the 
context, either a halfword or a fullword results. Examples of 
character symbols are: 


SYMBOL VALUE VALUE 
(HAL.FWORD ) (FULLWORD ) 
Cr, 002A 0000 002A 
Cr dy 3132 0000 3132 
C'AB' 4142 0000 4142 


C'1234' 3334 3132 3334 


2-4 | 48-050 FOO RO1 


In the last example, where a halfword value was generated, only 


the rightmost two characters were used. Where the context 
dictates a halfword, and a longer string is used, a_ truncation 
error results. One final type of implicit assignment occurs in 


the use of symbols as statement identifiers. Where a symbol is 
used in the name field of a statement, it is automatically 
assigned a value equal to the value of the current location 
counter (LOC). This type of assignment is covered in Chapter 4. 


2.3.2 Global Symbols 


Six symbols recognized by CAL/32 have predetermined values. They 
are: 


ADC 
LADC 
PURETOP 
IMPTOP 
ABSTOP 
x 


The use of these symbols is somewhat restricted, and they cannot 
be redefined by the programmer. 


In programs written for 32-bit processors, the address’~ length 
constant (ADC) always has a value of 4, the length of an address 
constant in bytes. (In 32-bit processors, addresses must be 
contained in fullwords, even though the actual address is only 24 
bits in length.) In programs for which CAL/32 is to generate 
16-bit code, ADC has the value of 2. In programs written for 
32-bit processors, the log (base 2) of the address length 
constant (LADC) always has a value of 2. In programs for 16-bit 
processors, LADC always has a value of 1. Both of these symbols, 
ADC and LADC, are used most frequently in common = mode 
programming. See Chapter 4. 


The symbols PURETOP, IMPTOP, and ABSTOP have values equal to: 


PURETOP The next available location in the pure segment 
IMPTOP The next available location in the impure segment 
ABSTOP The next available location in the absolute segment 


Because these values change during assembiy, the symbols must _ he 
used carefully. They can be used as second operand identifiers 
in machine instructions and as operands in assembler instructions 
where they are treated as address values. They cannot be used in 
assembler instructions that control the LOC. 
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The asterisk symbol (*), used as an operand rather than as an 
operator in an expression, always has a value equal to the value 
of the current LOC. Throughout the assembly process, CAL/32 
maintains a LOC analogous to the hardware LOC contained in the 
central processing unit (CPU). Depending on the organization of 
the program, this LOC can contain any one of several values. For 
32-bit programs, the LOC may point to the current location in the 
absolute segment, the pure segment, or the impure segment. For 
16-bit assemblies, the LOC may point to the current absolute 
location or the current relocatable location. 
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CHAPTER 3 
THE SOURCE PROGRAM 


3.1 INTRODUCTION 


The source program consists of asset of assembly language 
statements that specify the operations to be performed by the 
processor, define the constants and storage areas used by the 
program, and control the assembly process to produce the desired 
output. Source statements for Common Assembly Language/32 
(CAL/32) are of two types: comment statements and instruction 
statements. Instruction statements are further divided into 
machine instructions and assembler instructions. Each statement 
consists of an 80-character record, in which’ symbols and 
expressions identify the statement, and where necessary, indicate 
the operation and locate the operands. 


3.2 COMMENT STATEMENTS 


Comment statements can appear anywhere in the source’ program. 
They allow the programmer to include easy-to-read documentation 
in the source program listing. They produce no object code. The 
assembler does not process comment statements except to check for 
proper sequencing and scan for invalid characters. 


Comment statements must always start with an asterisk (*) in the 
first character position. Positions 2 through 71 can contain any 


printable ASCII character, including lowercase alphabetic 
characters. Blanks are considered to be "printable" characters. 
If a nonprintable character turns up in a comment statement, 
CAL/32 replaces it with a pound sign ,(#). Position 72 of a 
comment statement must contain a blank character. Positions 73 
through 80 can, at the programmer's option, be used for sequence 
identification. The sequence field can contain any printable 


ASCII character other than lowercase alphabetic characters. 
Where sequence checking is requested, each successive sequence 
identifier must be greater, in the ASCII collating sequence, than 
the previous identifier. Examples of comments are: 


POSITION 

1 — 72 73 
* THIS IS A COMMENT . 

* IT MAY APPEAR ANYWHERE IN THE PROGRAM 


* SUBROUTINE GETCHAR . . GET 10000 
*MOVES A CHARACTER FROM THE INPUT BUFFER GET10010 
*AND RETURNS IT IN GENERAL REGISTER THREE £GET10020 
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3.3 INSTRUCTION STATEMENTS 


Instruction statements can be written in fixed format or in free 


format. For either format, there are five distinct fields in 
each statement. In fixed format, these fields are: 
CHARACTER POSITIONS DEFINITION 
1 through 8 Name field 
10 through 14 Operation field 
16 through n Operand field 
n+2 through 71 Comment field 
73 through 80 Sequence field 


Positions 9, 15, and 72 must always contain blank characters. 
The operand field and the comment field are variable in length, 
and the first blank character after position 16 serves as a 
Gelimiter between the operand field and the comment field. 
Because of the way the output listing is tabulated, the comment 
field cannot contain more than 37 characters. If more than 37 
characters appear, only the first 37 are printed on the output 
Listing. 


CAL/32 does not require source statements to be written in fixed 
format. It accepts free format source, in which blank characters 
serve as delimiters. If, for example, the name field is not 
used, a blank character in the first position indicates that the 
next mnonblank character is the start of the operation field. 
Similarly, if the operation field requires fewer than five 
characters, the first blank character following the operation 
code indicates that the next nonblank character is the first 
character of the operand field. As in the fixed format 
statement, the first blank character following the operand field 
indicates the end of that field and the beginning of the comment 
field. There are three restrictions on the use of free format: 


1. Comment length is limited to 37 characters, including blanks. 
2. Position 72 must contain a blank character. 

3. The sequence field must start in position 73. 

The last restriction is because CAL/32 cannot distinguish between 


a blank character as part of a comment and a blank character 
intended to separate the comment from the sequence field. 
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If there are no nonblank characters in positions 1 through 20, 
CAL/32 assumes that the statement is a comment, and lists it as 
such with a warning note. If more than 15 blanks’ separate the 
name field from the operation field, CAL/32 assumes that the 
operation field is not present. Similarly, if more than 15 
blanks separate the operation field from the operand field, 
CAL/32 assumes that the operand field is not present. In both 
cases, CAL/32 generates an error message. 


When writing CAL/32 instruction statements, the programmer’ uses 
symbolic representation in the name field, the operation field, 
and the operand field. The following paragraphs describe the use 
of symbols and expressions in these fields. 


3.4 NAME FIELD 


Where a symbol appears in the name field, it represents the value 
of the current location counter (LOC) for that particular 


instruction. , This allows the programmer to refer to specific 
locations symbolically, without having to know the actual value 
of the LOC. The following five restrictions apply to the 


formation of names: 


1. The first character of a name must be an uppercase or 
lowercase alphabetic character or one of the special 
characters: 


e at sign (@) 
@e dot (.) 


@e dollar sign ($) 


NOTE 
) 
Lowercase letters are internally 
converted to uppercase except in string 


constants. 


2. The remaining characters can be made up of any combination of 
valid first characters, plus the numeric characters O through 
9. 

3. The name must consist of from one to eight characters. 


4. The name must start in the first character position of the 
source record. 


5. Imbedded blanks are not permitted. 
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Examples of valid names are: 


LABEL 
LOOP 1 
-SIN 

@GOTO 
$$GET5 


Examples of incorrect names are: 


1LLOOP First character is numeric 
LOOPCOUNTER More than eight characters 
AB?C Question mark is illegal 


As a general rule, a given symbolic string can appear only once 
in the program where it defines a location. That is, the same 
symbol may not appear in the name field of more than one 
instruction. The exception to this is the equate instruction. 
This is covered in the section on assembler instructions. 


3.5 OPERATION FIELD 


The use of symbols in the operation field is severely restricted. 
Only previously defined symbols can appear in this field. The 
symbols that appear in the operation field are called mnemonics; 
they represent operations to be performed by the processor at 
run-time, or operations to be performed by the assembler. CAL/32 
recognizes mnemonics that represent all machine operations for 
all Perkin-Elmer processors. It also recognizes a large set of 
assembler mnemonics that allows’ the programmer to control the 
assembly process. 
i 

Mnemonics can consist of no more than five characters. They are 
formed in the same way as names and use the same character set. 
CAL/32 permits users to define mnemonics. This process is 
described in the section that deals with the equate instruction. 
Specific mnemonics that define machine operations and assembler 
operations are described later in this chapter. Examples of 
operation mnemonics are: 


MNEMONIC ‘TYPE | MEAN ING 
AR Machine Add register 
Ss Machine Subtract 
CLI Machine Compare logical immediate 
ORG Assembler Set location counter 
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3.6 OPERAND FIELD 


CAL/32 permits the use of both symbols and expressions in the 
operand field of instructions. Symbols used in the operand field 
can be implicitly defined or can be explicitly defined. The 
rules for forming operands for assembler instructions vary from 
instruction to instruction, and each is described individually 
later in this chapter. 


Most machine instructions require two operands while some require 
only one. Where two operands are required, the first is 
separated from the second by a comma. Following are the general 
rules for forming operands for machine instructions. 


3.6.1 Register to Register (RR) Instructions 


Both the first and the second operand must be represented by 
symbols or expressions wilth values between O and 15 inclusive. 
If the value is greater than 15 or less than 0O, the assembler 
sets it to 0, and generates an error message. For example, if 
the symbols 1 and 2 appear in the operand field of the add 
register instruction: 


AR i,2 


CAL/32 generates the machine code to add the contents of register 
2 to the contents of register 1 and store the result in register 
its The use of 1 and 2 here is an example of how decimal numbers 
have an implicit value when used in the proper context. Another 
example: 


AR X'1',X'2' 


shows how hexadecimal symbols’ can be used as register 
identifiers. This is an exception to the previously stated rule 
that hexadecimal symbols generate halfword or fullword values. 
Where used as register identifiers, decimal, hexadecimal, and 
character symbols cause the assembler to generate 4-bit values. 


Expressions can be used in identifying registers, as in: 
AR AtB,C'A'-X'40' 


where CAL/32 evaluates the expressions and uses the results as 
the register identifiers. This is not a universally useful 
feature of the language, although it has some applications in 
common mode programming. 
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A more useful way to identify registers is to use explicitly 
defined symbols. Suppose the symbols SUM and INC are defined to 
have values of 1 and 2, respectively. Then the instruction: 


AR SUM, INC 
has the same effect as: 
AR 1,2 


3.6.2 Register and Indexed Storage (RX) Instructions 


If the first operand is required, it must be a valid register 
identifier as described for RR instructions. The second operand, 
separated from the first by a comma, can be: 


@® a symbol, 
@ an expression, or 


® a symbol or an expression followed by an index register 
identifier enclosed in parentheses. 


Where indexing is used, identification of the registers follows 
the same rules as those for specifying first or second operand 
registers. In double-indexed instructions, the first and second 
index identifiers are separated by a comma. An example of how 
(RX) instructions are written is: 


S 1,A 


where the first operand is the contents of general register 1, 
and the second operand is’ the value at location A in memory. 
Another example: 


Ss SUM, TABLE (PTR) 


shows how single indexing is expressed. In this case, the first 
operand is the value contained in the register identified by the 
symbol SUM, and the second operand is the value at memory 
location table plus the contents of the index register PTR. 
Another example: 


Ss SUM, LAST-FIRST (BASE, PTR) 
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shows the use of double indexing along with the use of an 
expression in the operand field. A final example: 


s SUM, 0(ADDR) 


illustrates where an address of a second operand is contained in 
the index register. Here, there must be a symbol in the address 
field even if it is equal to zero. 


3.6.3 Register and Immediate (RI) Instructions 


The first operand must be specified by a valid register 
identifier. The second operand can be: 


e® a symbol, 


@ an expression, or ) 


@ a symbol or an expression followed by an index register 
identifier enclosed in parentheses. 
Example: 


CLI STRNG,C'ABCD' 


causes the character string ABCD, represented internally as_ the 
fullword character value 4142 4344, to be compared with the 
contents of the register identified by the symbol STRNG. In 
another example: 


Ctl ADDR, LAST-FIRST (PTR) 


the expression LAST-FIRST is evaluated by CAL/32 at assembly 


time. At run-time this value is added to the contents of the 
index register before the comparison takes place. In another 
example: 


CLI ADDR, Y¥' 2000‘ (PTR) 


the fullword, hexadecimal quantity 0000 2000, is added to the 
contents of the index register. The result is then compared with 
the contents of the register identified by the symbol ADDR. 
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3.6.4 Register and Indexed Storage/Register and Indexed Storage 


(RXRX) Instructions 


The RXRX instructions have four basic source operand fields, each 
of which is separated from the other by a _ comma. The first 
operand field can be: 

e avalid register identifier, symbol, or expression with a 


defined absolute value in the 


@® an equal sign (=) preceding a 
defined absolute value in the 


The second source operand field, 


range O to 15; or 


symbol or an expression with a 


range O to 15, 


separated from the first by a 


comma, can be: 

@® a symbol or an expression; 

@® a symbol or an expression, optionally followed by an_ index 
register identifier enclosed in parentheses; or 

@® a symbol or an expression, optionally followed by a pair of 


index register identifiers, 
pair enclosed in parentheses. 


The third source operand field, separated from the 


comma, can be: 


@e® avalid register identifier, 
defined absolute value in the 

@ an equal sign (=) preceding a 
defined absolute value in the 


The fourth source operand field, 
comma, can be: 


@® a symbol or an expression; 


@ a symbol or an expression, optionally followed by an 


separated by a comma, with the 


second by a 


symbol, or expression with a 
range 0 to 15; or 
symbol or an expression with a 


range WGee LS. 


separated from the third by a 


index 


register identifier enclosed in parentheses; or 


@ a symbol or an expression, 
index register identifiers, 
pair enclosed in parentheses. 


optionally followed by 


a pair of 
separated by a comma, with the 
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Examples of how these instructions are written are: 
MOVE =LENGTH2,HERE, =LENGTH1L, THERE 


which moves the string of length, LENGTH1, at location THERE to 
the location HERE up to the number of bytes indicated by LENGTH2. 
If LENGTH1 is less than LENGTH2, this instruction pads the extra 
bytes with the right-justified character in general register 
zero. 


In the preceding example, the first operand field is the 
immediate value of symbol LENGTH2. The equal sign that specifies 
LENGTH2's value is an immediate value and not a register 
identifier. The second operand field is the storage address at 
location HERE. The third operand field is the immediate value of 
symbol LENGTH1L (its immediacy is again indicated by the equal 
sign). The fourth operand field is the string at location THERE. 


Another example is: 
MOVEP R7,PRINTOUT(LINE,COL2) ,R8,MESSAGE(CLASSX, ERRINDX) 


which moves the string of the length specified in general 
register R8, found at the memory location computed by summing the 
address value of MESSAGE with the contents of both index 
registers CLASSX and ERRINDX. The string is moved to a_e storage 
location whose address value is computed by summing the address 
value of PRINTOUT plus the contents of both index registers, LINE 
and COL2. The number of bytes to be filled is the length 
specified in general register R7. If the length in R8 is less 
than that in R7, the MOVEP instruction, by definition, pads the 
extra bytes with the default character, a space. 


In the preceding example, the first operand field is the register 
identifier, R7; the second operand field is the storage address 
at location PRINTOUT, as double indexed by the register 
identifiers, LINE and COL2; the third operand field is the 
register identifier, R8; and the fourth operand field is the 
string's location MESSAGE, as double indexed by the _ register 
identifiers, CLASSX and ERRINDX. 


Another example is: 


PMV =8,DECSUMS (SALESID) ,5,TOTALS (ORDERX) 


which packs and moves the unpacked decimal data digit string 
whose length is indicated in general register 5. Note that the 
5 means a general register because no equal sign precedes it. 
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The unpacked decimal data digit string is found at the memory 
location computed by summing the address value of TOTALS with the 
contents of the single index register identifier ORDERX. For 
details on how this conversion takes place, refer to the 
instruction definitions in the appropriate processor manuals. 
Generally, the unpacked decimal data is converted to packed 
decimal data up to the number of digits that may occupy the 


reserved byte length, indicated by the =8 expression. In this 
case, 8 bytes are reserved, providing storage for 15 decimal 
packed digits and a position for the sign-indicator. The PMV 


instruction, by definition, has various safeguards for illegal 
digit cases and overflow, and provides leading zeros as _ needed, 
when the number of positions available for either the unpacked 
digits and the packed digits is of unequal length. The memory 
location to which the converted digit data is moved is computed 
by summing the address value of DECSUMS with the contents of the 
single index register SAI.ESID. 


In the preceding example, the first operand field is the 
immediate value =8. Note that the equal sign specifies that 8 is 
an immediate value and not a register identifier. The second 
operand field is the address location DECSUMS as”) singly indexed 
by the register identifier, SALESID. The third operand field is 
the register identifier 5; and the fourth operand field is’ the 
address location TOTALS, as indexed by the single index register 
identifier ORDERX. 


3.7 COMMON ASSEMBLY LANGUAGE/32 (CAL/32) MACHINE INSTRUCTIONS 
Table 3-1 lists the mnemonics for CAL/32 machine instructions. 
Where there is no entry in the format column, that instruction is 
not available for that particular line of processors. 
NOTE 
Some machine instructions are illegal on 
the auxiliary processing unit (APU) in a 


Model 3200MPS System and are so noted in 
Table 3-1. 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 


Mme emt une enter emer eR I RII a Re OM LN ka NEA ROR TR A AR RR UN EO UN en “URE RA dh me Le ik OMe AAO wd rH otha soesin AR RAM Gro uneR elm pam RIA HARB nul eee pee 


| 32-BIT | 16-BIT 


i i 
INSTRUCTION } MNEMONIC {| FORMAT |} FORMAT 
face csr or oer gm cet om aoe ge oe ee gt eg oe ee om oe oe oe ae eo St eae ERT A aoe Son St ee Sr ST ee Ser at oe. ake oe Re er et oe et ee oe et ae ae oe 
| Add i A } RX | RX* 
| Add DP floating point | AD i RX | RX 
| Add DP floating point H H 

{ register i ADR | RR i RR 
i Add to bottom of list i ABL } RX i RX 
} Add to bottom of list \ | H 

i flagged | ABLF | RX** 
' ! | ] 

' t ' 1 

i Add with carry halfword } ACH | i RX 
i} Add with carry halfword H H H 

i register | ACHR i RR 
| Acknowledge interrupt | ACK ; RX 
| Acknowledge interrupt i 

} register i ACKR i RR 
| Add floating point i AE i} RX i RX 
{| Add floating point H H 1 

} register i AER i RR i RR 
| Add halfword i AH 1 RX i} RX 
{ Add halfword immediate | AHI i RIL i RI 
i Add halfword to memory | AHM i; RX } RX 
i Add halfword register i AHR | RR* i RR 
i Acknowledge interrupt i Al | i RX* 
i Add immediate i Al i; RI2 i RI* 
i Acknowledge interrupt H | H 

| register i AIR H i RR 
i Add immediate short i AIS | SF | SF 
ij Autoload | AL { RX% } RX 
i} Add to memory i AM i RX | RX 
| Add register i AR i RR | RR 
| Add to top of list ' } ATL i; RX | RX 
} Add to top of list flagged | ATLF { | RX 
| Branch and Link i BAL i RX i RX 
} Branch and link register | BALR | RR i RR 
i Branch to control storage |} BDCS 1 RX i RI 
i Branch on equal status H H { 

i high speed { BESHS | {| RX** 
| Branch on false condition H 

| backward short | BFBS | SF | SF 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 


(Cont inued ) 
INSTRUCTION | MNEMONIC 

Branch on false condition | BFC 
Branch on false condition |} 
register i BFCR 
Branch on false condition jj} 
forward short | BFFS 
Branch on not equal status | 
high speed | BNSHS 
Branch on true condition H 
backward short i BTBS 

{ 

! 
Branch on true condition i BTC 
Branch on true condition H 
register | BTCR 
Branch on true condition i 
forward short i BTFS 
Branch on index high i BXH 
Branch on index low or H 
equal | BXLE 
Compare ; C 
Complement bit i CBT 
Compare DP floating point | CD 
Compare DP floating point | 
register { CDR 
Compare floating point | CE 
Compare floating point H 
register | CER 
Compare halfword i CH 
Compare halfword immediate {| CHI 
Compare halfword register {| CHR 
Convert to halfword value | 
register i CHVR 
Compare immediate t “CI 
Compare logical i Ch 
Compare logical byte i CLB 
Compare logical halfword i CLH 
Compare logical halfword H 
immediate } CLHI 

i] 

t 
Compare logical halfword H 
register i CHR 


3 
F 


2-BIT 
ORMAT 


{| 16-BIT 
FORMAT 


RX 


u 


RR 


SF 


RX** 


pe ae eee ee ee ee ee ee ee ee ee ee ee me Se ee ee ee ee ee ee ee ee ee ee on ee ee wen we oe oe ie on wn ee om ee ee YP ee = 
a 
Fa 
* 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 
(Cont inued ) 


1 Ne MEN ve NR A Ta rN a MN UR SR OO A en a ee ale ie 


INSTRUCTION 


np RB BB eed eM a ee et i ee a a eh eed 


weet eta et SR sy Sa Re Soe eee See Sot Sk STF SEP ee Oe Se A es 


Compare logical immediate 
Compare logical register 
Compare register | 
Cyclic redundancy check 
modulo 12 


Cyclic redundancy check 
modulo 16 

Decrement counter high 
speed 


Divide DP floating point 
Divide DP floating point 
register 


i Divide floating point 
| Divide floating point 
} register 

i Divide halfword 
| Divide halfword register 

| Divide register 

i Enter control storage 

| Exchange program status 

| register 

i Exchange byte register 

i Exchange halfword register 
| Float DP register 

| Float register 

i Fix DP register 

| Fix register 

| Generate interprocess 

i} interrupt 

| Load 

| Load address 

i Load byte 

{ 

: 


Load byte high speed 
Load byte high speed 
indirect 

Load byte register 
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32-BIT 
econ 


RR 


| Ll6- -BIT 
FORMAT 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 


INSTRUCTION 


Load complement short 
Load DP floating point 
Load DP floating point 


register 


Load floating point 


Load floating 


register 


Load 
Load 
Load 
Load 


Load 
Load 
Load 
Load 
point 


halfword 
halfword 
haLlfword 
hal.fword 


immediate 
immediate short 
multiple 
multiple DP floating 


point 


immediate 
Logical 
register 


Load multiple floating 


point 


Load program status 
Load program status 


register 
Load PSW 


Load PSW register 
Load real address 
Load register 


Multiply 
Multiply 
Multiply 
register 
Multiply 
Multiply 
register 
Multiply 
Multiply 
Multiply 
Multiply 
register 


Move and 


DP floating point 
DP floating point 


floating 
floating 


halfword 
halfword 
halfword 
halfword 


point 
point 


register 
uns ignea@ 
uns igned 


process byte 
string register 


ee ee eee OE ee enn ee Re ee Ce ee ee ee ee nerd 


MPBSR 


INSTRUCTIONS AND MNEMONICS 
(Cont inued) 


32-BIT 
FORMAT 


RR3% 


i, en iY 


| 1l6-BIT | 
| FORMAT | 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 
(Cont inued) 


ee ee a et Onn ante onan 


INSTRUCTION 


Multiply register 

AND 

AND halfword 

AND halfword immediate 


AND immediate 
AND halfword register 
AND register 


Output command 


Output command register 
OR halfword 

OR halfword immediate 
OR halfword to memory 
OR halfword register 


OR immediate 

OR register 

Process byte 

Process byte register 

Read block 

Remove from bottom of List 
Remove from bottom of List 
£ lagged 

Read block register 

Reset bit 

Read data 

Read DCS 

Read data high speed 

Read data high speed 
register — . 

Read data register 

Read halfword 

Read halfword register 


Rotate left logical 
Rotate left logical short 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 


ENS TRUSTION 


Read process data high 


speed 


ee ee ee ce Mee re ror ey 


Replace PSW 


Rotate right logical 
Rotate right logical short 
from top of list 
from top of List 


Remove 
Remove 
f lagged 
Subtract 


Store byte high speed 


indirect 
Set bit 
Subtract 
halfword 
Subtract 
halfword 
Simulate 


Subtract 
Subtract 
register 
Subtract 
Subtract 
register 


with carry 


with carry 


register 


channel program 


DP floating point 
DP floating point 


floating point 
floating point 


Set program mask 


Set program mask register 


Subtract 
Subtract 
Subtract 
memory 

Subtract 
Subtract 
Simulate 
Subtract 


Shift left arithmetic 


halfword 


halfword immediate 
halfword from 


halfword register 
immediate 
interrupt 
immediate short 


MNEMON IC 


SHI 


INSTRUCTIONS AND MNEMONICS 
(Cont inued) 


32-BIT 
FORMAT 


RI1 


RX 


RX 


RX 


RR* 


ee ee ee 


} L6-BIT | 
| FORMAT | 
' 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 


(Continued) 
i } 32-BIT | 16~-BIT | 
| INSTRUCTION | MNEMONIC {| FORMAT {| FORMAT } 
ose ser em ar get a ge get ot em ee ee ee eer eto eee et et ae er ear 2 Gh ey St st se st at ge ge re ee oe me am ne ae ew ao eres ot an a ae | 
|} Shift left halfword | H | { 
| arithmetic | SHA i RIL i RI H 
|} Shift left halfword j i H { 
|} Logical . | SLHL i; RIL i RI H 
i Shift left logical i SLL rt RIL | RI 
| Shift left halfword i i H 
} Logical short i SLHLS | SF i RI H 
} Shift left logical short i SiLLS | SF | SF 
| Store PSW | SPSW H i RR** | 
i Subtract register i SR i RR | RR* H 
| Shift right arithmetic i SRA { RI1 i RI H 
i Shift right halfword H 
} arithmetic | SRHA i RIL ; RI { 
i Shift right halfword | H 
{| Logical } SRHL i RIL i RI H 
} Shift right logical } SRL i RIL i RI i 
| | | | 
} Shift right halfword H H H 
| Logical short | SRHLS | SF | SF i 
} Shift right logical short | SRLS | SF | SF H 
i Sense status i Ss i RX } RX i 
i Sense status register | SSR i RR i RR { 
| Store ; ST i RX : RX* 
i | 
| Store byte | STB | RX | RX i 
i Store byte high speed | STBHS H f .RX** | 
| Store byte register | STBR | RR i RR i 
j Store DP floating point i STD | RX | RX H 
ij Store floating point | STE i; RX i RX H 
} Store halfword i STH i} RX } RX i 
{| Store multiple | STM { RX { RX 
| Store multiple DP floating |} H H H 
{ point i STMD i} RX | RX H 
} Store multiple floating H | H 
} point i} STME i RX } RX H 
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TABLE 3-1 SUMMARY OF CAL/32 MACHINE 
INSTRUCTIONS AND MNEMONICS 


(Cont inued ) 

{ ' 32-BIT |} 16-BIT |} 

INSTRUCTION | MNEMONIC {| FORMAT {| FORMAT |} 
Supervisor call } SVC 1 RX | RX H 
Test bit i TBT | RX H { 
Test halfword immediate | THI ' RI1l i RI H 
Test immediate S. at i RI2 } RI* H 
Translate | TLATE | RX | RX** { 
Test and set i TS i RX H H 
Unchain { UNC 1 i RR**X | 
Write block { WB | RX$S {| RX ! 
Write block register | WBR i RRS {| RR 
Write data i WD { RX i RX H 
Write DCS i WwDCS } RR { RR H 
1 J { J 

i} ! t t 

Write data register } WDR H RR ; RR H 
Write data high speed | WDHS ' ; RX** | 
Write data high speed H H H H 
register | WDRHS i H RR * * H 
Write halfword } WH | RX i RX H 
Write halfword register | WHR : RR i RR 1 
t { ] ! 

I ] ' 1 

Write processed data high | H H H 
speed | WPDHS 1 RX** | 
Exclusive OR i Xx ; RX i RX* H 
Exclusive OR halfword | XH i RX i RX H 
Exclusive OR halfword H H H H 
immediate i XHI t RIL i RI H 
Exclusive OR halfword H H H i 
register | XHR ; RR* i RR H 
| t i J 

I { t { 

Exclusive OR to memory i XHM H ; RX** H 
Exclusive OR immediate im oe i RI2 ; RI* H 
Exclusive OR register i XR ; RR ; RR* H 


oe 


6% 
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The indicated mnemonic operation code is generated, 


and the listing is flagged with a question mark 
indicate a potential error. 


Model 50 instruction set. 


These instructions are illegal on the APU of 
Model 3200MPS System. 


Not applicable to Model 3200MPS System processors. 


48-050 


to 
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There are three new machine instructions for the APU of the Model 
3200MPS System. They are summarized in Table 3-2. See the Model 
3200MPS Instruction Set Manual for an explanation of these new 
machine instructions. 


TABLE 3-2 CAL/32 MACHINE INSTRUCTIONS AND MNEMONICS 
FOR THE MODEL 3200MPS SYSTEM 


H | 32-BIT } 
H INSTRUCTION | MNEMONIC {| FORMAT } 
; Generate Signal (Model H GSIG H RR H 
| 3200MPS APU only) H H H 
1 t ' ' 
i} I t ( 
i} Read real-time counter 1 RRTC H RR H 
| (Model 3200MPS APU only) ! 
! ! l i 
{ | { t 
| Reschedule (Model 3200MPS _ } RSCH { SF H 
! ! ‘ 
( t 


APU only) | 


am mT OL Se fone A HRD Nm LN Crem ning NY ES NeyEeS ee inte comets Ht eae Me A tae Tom RO eR SR OR Wel cng err ean are eon nee ec AOR nm ema me Lim ASA OO 


OS/32 RO7.1 and higher wiil simulate these instructions on other 
processors. 


The semantics of the privileged system function (PSF) are 
modified for the APU of the Perkin-Elmer Model 3200MPS System. 
Table 3-3 lists the mnemonics of machine instructions and 
mnemonics for the Series 3200 processors. The 16-bit format is 
not applicable. 
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‘TABLE 3-3 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS AND 
MNEMONICS FOR THE PERKIN-ELMER SERIES 
3200 PROCESSORS 
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| 32-BIT | 

INSTRUCTIONS | MNEMONIC | FORMAT {| 

Sere ee ee ee eee eee eee eee ee ee ee ze: | 
Breakpoint i BRK i} RR { 
Compare alphanumeric (RO=pad) | CPAN { RXRX | 
Compare alphanumeric and default |} 
pad | CPANP | RXRX | 
Load interruptible state | ISRST* {| RX H 
Save interruptible state i ISsv* 1 RX 
( i ' 

' ! ' 

Load complement SP register | LCER : RR i 
Load complement DP register } LCDR : RR H 
Load DP register from SP memory | LDE | RX 
Load DP register from SP register ; MLDER | RR 
Load DP register from general H H t 
register pair i LDGR i RR H 
{ ' ! 

' ' 4 

Load process state | LDPS* i RX H 
Load SP register from DP memory i LED i} RX H 
Load SP register from DP register | LEDR i RR 
Load SP register from general H 1 
register | LEGR ; RR i 
Load general register pair from H { 
DP register | LGDR i RR H 
I y i 

! t { 

Load general register from SP H H H 
register | LGER i RR H 
Load packed decimal string as { H 
binary | LPB 1 RX H 
Load positive DP register | LPDR ; RR H 
Load positive SP register i LPER i RR 
Load process segment table H 
descriptor i LPSTD* {| RX H 
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TABLE 3-3 SUMMARY OF CAL/32 MACHINE INSTRUCTIONS AND 
MNEMONICS FOR THE PERKIN-ELMER SERIES . 
3200 PROCESSORS (Continued) 


| 32-BIT | 
INSTRUCTIONS | MNEMONIC {| FORMAT | 
[2 5 Sa Sr a me OME ST A A A nO | 
| Load shared segment table I 
| AGescriptor | LSSTD* | =RX H 
| Move and pad (RO=pad) | MOVE i RXRX | 
| Move and pad default pad i} MOVEP | RXRX | 
| Move translated until 1 MVTU | RXRX | 
| Pack and move | PMV | RXRX | 
| Pack and move absolute | PMVA | RXRX | 
| Read error logger | REL* | RXL H 
| Reset memory voltage failure | RMVF* } RXL*** | 
; Store DP register in SP memory | STDE | RX 
| Store binary as packed decimal 
| string | STPB | RX H 
i Store process state 1 STPS* i RX H 
| Unpack and move i UMV t RXRX | 
| Unpack and move absolute i UMVA | RXRX | 
| Store byte with no ECC | XSTB* 


eR eae ee en RE er ne nen eee nen ire ere ane ree ens 


* PSF modified for APU 


*** No register or other operands allowed in = source 
format 


In addition to the set of mnemonics listed in Tables 3-1 through 


3-3, CAL/32 recognizes a complete set of extended branch 
mnemonics. These instructions allow the programmer to call for 
conditional branch instructions without having to state 


explicitly the condition code _ mask. Table 3-4 lists these 
instructions. 
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TABLE 3-4 EXTENDED BRANCH MNEMONICS 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


Branch 
Branch 
Branch 


INSTRUCTION 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


on 
on 
on 


carry 
carry register 
carry short 


no carry 
no carry register 
no carry short 


equal 
equal register 
equal short 


not 
not 
not 


equal 
equal register 
equal short 


Low 
low register 
low short 


low 
low register 
low short 


not 
not 
not 


minus 
minus register 
minus short 


not minus 
not minus register 
not minus short 


plus 
plus register 
plus short 


not plus 
not plus 
not plus 


register 
short 


overflow 
overflow register 
overflow short 


no overflow 
no overflow register 
no overflow short 


ee ee ne rt MR ene cme erm cman mem mmo tay, OT Demy mam ea nm mst rm RL rate SO A LA ae Ue OE ieee 


MNEMONIC 


BC 
BCR 
BCS 


BNC 
BNCR 
BNCS 


BE 
BER 
BES 


BNE. 


BNER 
BNES 
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TABLE 3-4 EXTENDED BRANCH MNEMONICS 


(Cont inued) 
\ INSTRUCTION } MNEMONI { 
| Branch on zero H BZ H 
| Branch on zero register 1 BZR H 
| Branch on zero short H BZS H 
1 ! ( 
t ' f 
| Branch on not zero H BNZ H 
i Branch on not zero register BNZR 
| Branch on not zero short H BNZS H 
{ t i 
! ' t 
| Branch unconditional H B H 
| Branch unconditional register H BR 
| Branch unconditional short | BS H 
' ( t 
| ' t 
i No operation | NOP H 
| No operation register H NOPR { 


ee rae me NS cam I km ame RA RR) mR SM ee nN ne rm SUFI re OR wm my UNTER aN RO A sim tah mB Mem etm lt ee co 


The extended branch instructions are essentially single operand 
instructions where the first operand (mask) value is included in 
the operation mnemonic. The programmer supplies only the operand 
or branch location. For short branches, the programmer does not 
have to specify the forward or backward direction. CAL/32 
determines the direction of the branch and generates’ the 
appropriate machine code. For example: 


LOOP1 L STRNG , TABLE (PTR) LOAD STRING FROM TABLE 
CLR STRNG, INPUT COMPARE WITH INPUT 
BES END EQUIVALENT FOUND 
AIS PTR,4 NOT FOUND INCREMENT PTR 
BNZS LOOPL GET NEXT STRING 
LIS STRNG,O NOT FOUND END OF TABLE 
END ST STRNG, RETURN RETURN VALUE 


In this program, CAL/32 determines the locations of LOOP1] and END 
and generates the required forward and backward branch 
instructions. 

Two more CAL/32 instructions that do not have direct machine 
equivalents are: 


INSTRUCTION MNEMON [C 


Branch on true condition short BTCS 
Branch on false condition short BFCS 


48-050 FOO ROL | @23 


With these instructions, the programmer must specify the mask 
value and the branch location. CAL/32 determines the direction, 
forward or backward, and the appropriate machine operation is 
generated. 


3.8 ASSEMBLER INSTRUCTIONS 


Assembler instructions control the assembly process. Although 
they may resemble machine instructions in form, they do not 
generate any machine executable code. They are used to define 
symbols, reserve storage, generate data constants, and control 
the final output. 


3.8.1 Symbol Definition Instructions 

Symbol definition instructions allow the programmer to assign 
values to symbols and set up communication paths between 
separately assembled programs. The latter operation facilitates 
the use of subroutines because they can be written and assembled 
separately from the main program. At load time, a linking loader 
uses information supplied by CAL/32 to resolve addresses between 
main programs and subroutines to set up the correct linkage. 
3.8.1.1 Equate (EQU) Instruction 

This is one of the most commonly used assembler instructions. It 
assigns values to symbols and it has the form: 


NAME OPERATION OPERAND 


A symbolic name EQU An expression 


Examples of EQU instructions are: 


LOOP EFQU LOOP1 

TOP EQU  END-64 
DELTA EQU BOTTOM-TOP 
HERE EQU * 

START EQU X'10FE' 
SUM EQU) 1 

PTR EQU 2 
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EQU instructions can appear anywhere in the program. CAL/32 
requires that each EQU instruction have a symbol in the name 
field and treats the absence of this symbol there as an error. 
The value assigned to a symbol by an EQU instruction is absolute 
or relocatable, depending on the type of expression in the 
operand field. If the operand of an EQU statement contains a 
forward reference, CAL/32 will perform any additional passes 
required to define all symbols. CAL/32 does not reserve storage 
for symbols defined by an EQU- instruction. Wherever it 
encounters the symbol in the program, CAL/32 replaces the symbol 
with the value defined in the EQU instruction. For example: 


STRNG EQU) 1 

PTR EQU 2 

INPUT EQU 3 

LOOP 1 L STRNG,TABLE(PTR) LOAD STRING FROM TABLE 
CLR  STRNG, INPUT COMPARE WITH INPUT 


In this case, CAL/32 generates the code to load register 1 with 
four bytes located at the address specified by TABLE, indexed by 
register 2. The next instruction causes CAL/32 to generate the 
code to compare the four bytes in register 1 with the contents of 
register 3. The use of the EQU instruction here allows the 
programmer to assign meaningful names to the registers that hold 
the character strings, and index into the table. It also 
provides a simple way to redefine the values assigned to these 
symbols. By changing the EQU instructions and reassembling, it 
is possible to change the values assigned to the symbols without 
doing extensive editing to change each individual statement where 
these registers are used. . 


It is also possible, although not recommended, to redefine a 
symbol within a program. For example: 


LOOP 1 EQU * 


LOOP 1 EQU * 


48-050 FOO RO1 — 3-25 


When the symbol LOOP1 is encountered in the first EQU 
instruction, CAL/32 assigns it the value of the LOC. Subsequent 
references to LOOP] receive this value. Following the second EQU 
instruction, the value of LOOP1 is changed to the value of the 


new LOC. Because such redefinitions might not be intentional, 
CAL/32 issues a warning message wherever a symbol is redefined by 
an EQU instruction. (In the example, the programmer might have 


intended to write LOOP2 instead of LOOP1 in the second EQU 
instruction. ) 


The user must guard against circular LOC dependency, as shown in 
the following example: 


A EQU * 
DS 1 
DS B-A 

B EQU * 
END 


CAL/32 will flag an "MOO1l xxxTOP" error where xxx is PURE, IMP, 
or ABS, depending upon the current LOC. 


As stated earlier, CAL/32 permits the user to define operation 
mnemonics within the program. To do this, the user defines the 
new mnemonic in an EQU instruction in which the new operation 
mnemonic is in the name field, and the operand field contains a 
hexadecimal constant of the form X'nnxy'. Here, nn is’ the 
machine language operation code, and x and y are descriptors that 
tell CAL/32 how to handle the new mnemonic. The values of x and 
y inform CAL/32 of the instruction format. The values are 
defined as follows: 


RR or SF format 
RX or RI format 
RI1 format 
RI2 format 


mM PM OM 
Hou non 
ane 
<e<S<NS 
Hoo ON 
Md N00 
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To define extended branch mnemonics, x gets a value equal to the 
Rl field (mask) and y gets one of the following values: 


3 RX format 
Cc RR format 
D SF format 


how oN 


Y 
Y 
Y 
For example, in the instruction: 


BTC 15,ADDR 


the branch on true condition mnemonic and the mask field 15 can 
be combined into an extended branch instruction as follows: 


BTCF FQU xX'42F3' 


in which BTCF is the new mnemonic; 42 is the machine code for the 
branch on true condition instruction; F is the mask value (15); 
and 3 specifies RX format. Once this new mnemonic is defined, 
the programmer can write: 


BTCF ADDR 
instead of: 
BTC 15,ADDR 


The new mnemonic definition remains in effect only for the 
program in which it is defined. The new mnemonic must be 
different. from all other mnemonics recognized by CAL/32. 


There are three things to remember in using equate statements: 


1. The name field must always contain a valid symbol. 


2. The operand field must always contain a defined symbol or 
expression. 


3. The symbol that appears in the name field of an equate 


instruction must not appear in the name field of any other 
instruction, except another equate instruction. 


If any of these rules are violated, CAL/32 generates an 
appropriate error message. 
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3.8.1.2 External, Entry, Weak External, Weak Entry, and 
Data Entry (EXTRN, ENTRY, WXTRN, WNTRY, and DNTRY) 
Instructions 


These instructions are listed together since they perform 
corresponding functions to establish links between main programs 
and subroutines, and between programs with a common data base. 
These instruction forms are: 


NAME OPERATION OPERAND 
Not used EXTRN One or more symbols 
(illegal) s@éparated by commas 
Not used ENTRY One or more symbols 
(illegal) separated by commas 
Not used WXTRN One or more symbols 
(illegal) separated by commas 
Not used WNTRY One or more symbols 
(illegal) separated by commas 
Not used DNTRY One or more symbols 
(illegal) separated by commas 


The EXTRN instruction identifies symbols referenced by the 
program but defined outside the program. The ENTRY instruction 
identifies symbols defined within the program and referenced 
externally. (They can be referenced internally as well.) 


For example, consider two programs: one calculates the sine and 
cosine of an angle, the other uses the sine and cosine. The 
first is a general purpose program that could be used by many 


other programs. The ENTRY and EXTRN’ instructions make this 
possible without having to assemble the sine and cosine program 
every time it is needed. The sine and cosine program would 


contain an ENTRY instruction and entry points such as: 


ENTRY SIN,COS 
SIN EQU = 


cos EQU- * 
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The symbols SIN and COS appear as operands in the ENTRY 
instruction and as names in the EQU instructions. When CAL/32 
assembles this program, CAL/32 informs the linking loader § that 
the locations identified by the names’ SIN and COS are entry 
points into the program. 


The program that uses sine and cosine would contain an external 
statement and branch instructions such as: 


EXTRN SIN,COS 
BAL LINK,SIN 


BAL LINK, COS 


At assembly time, CAL/32 generates object data to inform the 
linkage editor that the symbols SIN and COS are externally 
defined. At link time, the linkage editor uses this information, 
along with the information generated by the entry instruction in 
the other program, to provide the necessary Linkage. 


The WXTRN instruction is essentially equivalent to the EXTRN 
instruction. However WXTRN symbols are subject to the following 
exception processing by Link: 


@e An error condition does not arise if the symbol is not 
resolved. 


e Object libraries are not searched in order to satisfy a weak 
external. 


e If a module containing an entry point referenced by a WXTRN 
symbol is included, then the entry point will be used to 
satisfy WXTRN references to it in the normal fashion. 


The WNTRY instruction is essentially equivalent to the ENTRY 
instruction. However, WNTRY symbols are subject to the following 
exception processing by Link. 


@ Weak entry points are not examined when searching an object 
library. Therefore, a program module containing a weak entry 
point is not included to satisfy an external reference. 


e If a program module containing a weak entry point is included 


from a module, the weak entry point will be used to satisfy 
external references in the normal fashion. 
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The DNTRY instruction is essentially equivalent to the ENTRY 
instruction. However, symbols nominated by DNTRY are resolved 
directly when building overlaid modules rather than resolved _ in 
an SVC instruction. This instruction identifies a symbol defined 
local to the program containing the DNTRY instruction. 


To help protect references to data in higher level nodes, Link 
automatically loads the entire path of overlays starting at the 
overlay containing data and ending with the overlay making the 
reference to a data entry point (DNTRY). A reference to a 
program section positioned in a higher level node, via _ the 
POSITION command, is treated the same way. A reference to data 
or a program section in the root will not cause a path of 
overlays to be loaded. 


If a DNTRY is referenced in a lower level node, an SVC 5 manual 

overlay load might be required to insure that the overlay is in 

memory at the time of the reference. 

Restrictions on the use of external and entry instructions are: 

e The operand field of an external instruction must not contain 
an expression, such as SIN+4. 

e Expressions involving externally defined symbols must be of 
the form: 


- External symbol + absolute expression 


- External symbol - absolute expression 
BAL LINK,SIN+4 
is a legal use of an externally defined symbol. 


e Externally defined symbols cannot be used internally as 
instruction identifiers. 


e Any symbol identified as an entry must appear internally § in 
the name of an instruction. 


@e Symbols identified as entries cannot be redefined by multiple 
equate instructions. 
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3.8.1.3 Include (INCLD) Instruction 


This information provides Link with a mechanism to guarantee the 
inclusion of object modules without other linkage references to 
it. It has the form: 


NAME OPERATION OPERAND 
Not used INCI.D One or more 
(illegal) symbols 

separated by 
commas 


The INCLD is used in the same fashion as the EXTRN to linking 
references. However, this instruction is used to nominate 
program modules rather than external symbols. 


NOTE 


CAL/32 generates the same object as in 
the past, provided none of the following 


instructions are used: external with 
offset, DCMD, DNTRY, WNTRY, WXTRN, or 
INCLD. The assembly of any of these 


instructions produces an object that TET 
will reject. Link is required to process 
modules containing this extended object. 
These instructions are only valid in a 
Target 32 assembly and have no effect on 
16-bit object generation. 


3.8.2 Data Definition Instructions 


These instructions allow the programmer to reserve areas of 
memory to be used at run time. Some of these instructions allow 
the programmer to specify values with which these areas can be 
initialized at load time. Other data definition instructions 
provide easy access to complex data structures. 
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3.8.2.1 Define Storage (DS, DSH, DSF) Instruction 


This instruction causes CAL/32 to reserve a block of storage 
within the program without initializing the reserved locations to 
any value. It has the form: . 


NAME OPERATION OPERAND 
A symbol DS A previously defined absolute 
(optional) expression 
A symbol DSH A previously defined absolute 
(optional) 6xpression 
A symbol DSF A previously defined absolute 
(optional) expression 


The DS mnemonic causes CAL/32 to reserve the specified block of 


storage starting from the value of the current LOC. 
In the DSH form, CAL/32 first aligns the LOC on a halfword 
boundary and then reserves the storage. In the DSF form, CAL/32 
first aligns the LOC on a fullword boundary. Examples of the 


define storage instruction are: 


BUF 1 DS 100 
BUF 2 DSH 125 
BUF 3 DSF 16 


In the first example, CAL/32 réserves 100 bytes of storage by 
simply adding 100 to the LOC. In the second example, CAL/32 
reserves 125 halfwords (250 bytes) of storage. CAL/32 does’ this 
by aligning the LOC on a halfword boundary, if it is not already 
properly aligned, and then adding 250 to it. In the third 
example, CAL/32 ensures that the LOC is aligned on a fullword 
boundary and then adds 64 (the byte equivalent of 16 fullwords) 
to it. If the operand contains a forward reference, CAL/32 will 
perform any additional passes required to define all symbols. 
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Define storage instructions are commonly used to reserve’ storage 
areas for transient data. Examples of this are I/O buffers and 
register save areas. For example: 


ENTRY RSAVE 
EXTRN SIN,COS 
LINK EQU 15 


RSAVE DSF 16 


BAL LINK,SIN 


shows how a main program might set up a register save area within 
itself. The code for the called program might look like: 


ENTRY SIN,COS 
EXTRN RSAVE 
RO EQU 0 


SIN FQU * 
STM  RO,RSAVE 


where the subroutine stores the general registers’ in the 
externally defined area, RSAVE. When using define storage 
instructions remember that: 


e The DSH and DSF forms of the instruction ensure halfword and 
fullword alignment. 


e The define storage instructions do not initialize memory to 
any particular value. 


@e Only one operand is allowed in a define storage instruction, 
and it must be a defined, absolute symbol or expression. 
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3.8.2.2 Define Constant (DC, DCF) Instruction 


The define constant instruction allows the programmer to reserve 
areas of memory and at the same time specify the initial value to 


be loaded into’ them. The define constant instruction has two 
forms: 
NAME OPERATION OPERAND 
A symbol DC One or more operands 
(optional) separated by commas 
A symbol DCF One or more operands 


(optional) separated by commas 


The DC mnemonic ensures that the first of the operands is aligned 
on a halfword boundary. The DCF mnemonic ensures that the first 
of the operands is aligned on a fullword boundary. Operands of 
different types can be used in the same define constant 
instruction. However, where alignment is a concern, the 
programmer must be careful in mixing operands of different types. 
Types of operands are described below. 


A single character code indicates the type of constant. This 
character code is not always required, and the exceptions are 
noted as they occur. The assembler determines from the character 


code how it is to interpret the constant and translate it into 
the proper object format. Table 3-5 lists the character codes 
recognized by CAL/32, their meanings, and the types of constants 
generated. 
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TABLE 3-5 CONSTANT TYPES 


ee a oe ae a ee ee ar et ae rT ers some tte 


string integer of 7-bit ASCII 
encoded decimal digits 
(8-bits per digit) ina 
string of variable byte 
length. 


me pee ee A Ne eee RN RE crak Rm comme eee RAD IN ae AO En I Me ARE LS MR RE HE Nata I OU ni oe Ue RY nem eee SS SO Sone RE OA Oem iam me er tee 


| CODE | MEAN ING { MACHINE FORMAT H 
H Se SESS a ESD oe ee ee er ek ee ee ee et Get oe er St er ce cert tor eo eo ee eo et te a a me a | 
1 Xx | Hexadecimal | L6-bit binary H 
i; Y¥ | Hexadecimal ; 32-bit binary H 
i 4H | Integer ; L6-bit signed binary 
| F | Integer | 32-bit signed binary 
i A | Address ; 32-bit value of address 
i 2 | Address | L6-bit value of address 
ee | | Address | One half of 16-bit address | 
i ££ | Single precision {| 32-bit floating point 
| floating point | format H 
i D | Double precision | 64-bit floating point H 
| Lloating point ; format H 
¢. ; Character | An 8-bit code per { 
H H { character (7-bit ASCII) H 
t ! | { 
I t | ( 
i -P i Packed decimal | Fixed point sign-coded H 
| string | integer of binary en- 
H ; coded 4-bit decimal H 
H H | Gigits ina string of H 
| variable byte length. 
t ‘ | t 
' t 1 ' 
i U | Unpacked decimal | Fixed point sign-coded H 
’ ! ! ! 
a ! | 
| 
| 
| 
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3.8.2.3 Hexadecimal Constants 


A hexadecimal constant consists of one or more hexadecimal 
digits, 0O through 9 and A through F, enclosed in apostrophes and 
preceded by the type code X or ¥Y. Where the xX type is used, 
CAL/32 reserves two bytes of storage and generates the loader 
information that will cause those two bytes to be initialized at 
load time with the binary representation of the hexadecimal 
number. The Y type causes four bytes to be reserved and 
initialized. Examples of hexadecimal constants are: 


CONSTANT VALUE 
DC X'1234' 1234 
DC ¥'1234' 0000 1234 
DCF xX'‘'20' 0020 
DCF Y'0064' 0000 0064 
DC X'1234ABC' 4ABC 


The first example shows a halfword hexadecimal constant which, 


because of the DC operation code, is aligned on a halfword 
boundary. The second example shows a fullword hexadecimal 
constant. In this case, fullword alignment is not guaranteed. 
The third example shows a halfword constant aligned on a fullword 
boundary. The fourth example shows how to force fullword 
alignment for a fullword constant. The last example shows what 
happens when too many digits are given. CAL/32 truncates the 


constant to the least significant digits and generates an error 
message. The maximum number of digits for an X type constant is 
four. The maximum number for a Y type constant is eight. 


NOTE 


Where fewer than the maximum number of 
digits are given, CAL/32 right justifies 
the value in the location and fills in 
the missing digits with zeros. 


Two special mnemonics facilitate the building of hexadecimal 


tables by eliminating the need to specify the X or Y type code. 
They have the form: 


NAME OPERATION OPERAND 
A symbol DCX One or more operands 
(optional) separated by commas 
A symbol DCY One or more operands 
(optional) separated by commas 
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Operands for these instructions consist of from one to _ four 
hexadecimal digits for the DCX instruction and from one to eight 
hexadecimal digits for the DCY instruction. Examples of these 
constants are: 


DCX 1,0,14AE,20,4040 
DCY 1, 2FFFE,64, 80000000 


The DCX instruction generates five halfword constants as follows: 


elelenn 
0000 
14AE 
0020 
4040 


The DCY instruction generates four fullword constants as follows: 


0000 0001 
0002 FFFE 
0000 0064 
8000 0000 


Before generating the constants, CAL/32 ensures that they are 
properly aligned with halfword constants aligned on halfword 
boundaries and fullword constants aligned on fullword boundaries. 


3.8.2.4 Integer Constants 


Integer constants can be either halfword or fullword.  Halfword 
constants are expressed by the character code H followed by a 
string of from 1 to 5 decimal digits enclosed in apostrophes. 
Fullword constants are expressed by the character code F followed 
by a string of from 1 to 10 decimal digits enclosed _ in 
apostrophes. The range of halfword constants is from -32,768 to 


+32,767. The range of fullword constants is from -2,147,483,648 
to +2,147,483,647. The decimal strings used in these constants 
must not include commas or blanks. A sign, + or -, can precede 


the string. 


The internal representation of integer constants is two's 
complement binary. In this notation, positive numbers and zero 
have their true binary form. For example, a halfword integer 
with a value of 25 is represented internally (hexadecimal 
notation) as: 


00 
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Negative numbers are expressed in accordance with the formula: 
Value = 2 - x 


where n is the number of bits used to express the value, and x is 
the absolute value of the number. For example, to represent 
minus 10 in a halfword constant: 


n = 16 (10%6 ) 
x = 10 (Aig) 
Value = 10000,, a Ais = FFF 6i6 


Examples of integer constants are: 


CONSTANT VALUE 
DC H'32767' TF FF 
Dc H'~-32768' 8000 
DC F'1’ 0000 OOO1 
DC HY 2" FFFE 
DCF F'25' 0000 0019 


The H and F codes themselves do not guarantee correct alignment. 
To ensure that a fullword integer is aligned on a fullword 
boundary, the programmer should use the DCF instruction. 


CAL/32 does not require that integer constants be defined with 
the character codes and decimal strings enclosed in apostrophes. 
A simple decimal string can be used. For example: 


DC 1 
DC tf 


The length of the integer constants generated by these 
instructions depends on the processor on which the program is to 
run. For 32-bit processors such instructions generate fullword 
constants, such as: 


CONSTANT VALUE 
DC 1 0000 0001 
DCF -7 FFFF FFF9 


3-38 48-050 FOO ROL 


For 16-bit processors, these instructions generate halfword 
constants, such as: 


CONSTANT VALUE 
DC 1 0001 
DC a | FFF9 


It is possible to force a fullword alignment by using the DCF 
mnemonic with a simple decimal string. The use of a DCF 
instruction affects only the alignment of the first of the 
integer constants; the length of the constant is determined 
solely by the processor on which the program is to be run. Thus, 
when using these instructions with operands which are simple 
decimal strings, it is not possible to generate a halfword 
constant for a 32-bit processor. 


3.8.2.5 Address Constants 


Address constants consist of a single character type code 
followed by a symbol or an expression enclosed in parentheses. 
The three types of address constants are A, Z, and T. Type A 
constants generate fullword address constants in programs 
intended to be run on 32-bit processors; they generate halfword 
address constants in programs intended to be run on 16-bit 
processors. Types Z and T address constants always generate 


halfword values. Examples of address constants are: 
DC A(LOOP +2) 
DC A( TABLE ) 
DC A( TOP-BOTTOM) 
DC Z( IOVECTOR) 
DC T (AL.PHATAB ) 
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For 32-bit processors, the first three examples cause CAL/32 to 
reserve a fullword of storage, initialized at load time to 
contain the value of the expression or symbol enclosed in 
parentheses. This value can be absolute or relocatable, 
depending on the nature of the expreasion. The address quantity 
is right justified in the least-significant 24 bits of the 
fullword, and the most-significant 8 bits are forced to zero. 
However, it is possible to use the mast-significant bits for some 
purpose. They might be used as flag bits as in the example: 


PARAM DS 4 

ADDR Dc A(PARAM+Y 'A0000000' ) 
EXTRN SIN 

LINK EQU 15 

ADREG EQU 14 


STE RO, PARAM 
L ADREG , ADDR 
BAI, LINK,SIN 


At the time of the branch and link instruction, register 14 
contains the address of the location PARAM in the 
least-significant 24 bits. The most-significant 8 bits contain 
the value X'AO'. The subroutine can use the address portion and 
the flag portion independently, as: 


SIN EQU * 
LE R4,0(ADREG) GET PARAMETER 


TI ADREG, Y'AQOOOOOO' TEST FLAGS 


The Z type address constants generate halfword values. They can 
be used in programs for 32-bit processors if the programmer is 
certain that the actual address cannot exceed 65,535, the maximum 
unsigned value that can be expressed in a halfword. 
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The T type address constants are used as entries in translation 


tables. These instructions cause CAL/32 to reserve a halfword of 
storage initialized with one half of the actual address, right 
justified. The most significant bit is zero. These constants 


are intended for use with the translation tables associated with 
the translate instruction and with the auto driver channel. 


Address constants can be written without the type code and 
parentheses, as in: 


TABLE DS 16 
BUFF 1 DS 64 
ADD1 DC TABLE ADDRESS OF TABLE 


ADD2 DC BUFF 1 ADDRESS OF BUFFER ONE 


Where this convention is used, the size of the generated constant 


depends on the processor for which the program is written. For 
32-bit assemblies, CAL/32 generates fullword constants. For 
16-bit assemblies, CAL/32 generates halfword constants. The 


programmer can force halfword constants to be generated by using 
the mnemonic DCZ, as: 


DCz TABLE, BUFF 1 


which causes a series of halfword address constants to be 
generated. 


3.8.2.6 Floating Point Constants 

The source form for floating point constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
E for single precision, or the letter D for double precision. 
The decimal number consists of: 

@® an optional plus sign or minus sign, 


@® one or more decimal digits that may include a decimal point, 
and 


@ an optional E character followed by an optional plus sign or 


minus sign, followed by one or two decimal digits denoting a 
power of 10. 
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Single precision floating point constants require a fullword of 
storage. Double precision floating point constants require a 
doubleword of storage. Internally, floating point constants are 
represented in excess 64 notation. In this kind of notation, 
each floating point number consists of a sign, an exponent, and 
a fraction. The first bit of the number is the sign bit. If 
this bit is al, the number is negative; if it is a 0, the number 
is positive. The next 7 bits represent the exponent, expressed 
in excess 64 notation. This field can contain any value between 
O and 127 inclusive. The remaining bits, 24 for single precision 
and 56 for double precision, represent the fraction with an 
implied radix point before the first bit. 


The true value of the floating point number is obtained by 
multiplying the fraction by 16 raised to the power indicated by 
the exponent field. In excess 64 notation, this power is 
determined by subtracting 64 from the value in the exponent 
field. In this way, values equal to or greater than 64 produce 
a 0 or positive power. Raising 16 to this power and then 
multiplying by the fraction produces values between .0625 and 7.5 
x lO. Exponent field values that are less than 64 produce a 
negative power and values between .06249... and 5.4 x 10- 
Floating point O is represented by a fullword or a doubleword of 
zeros. 


Examples of floating point constants are: 


CONSTANT INTERNAL REPRESENTATION 
DC E* 1? 4110 0000 

DC E'OQ.0' 0000 0000 

DC E'7.2E74' 7F19 7817 

DC D*:10.5* 41A8 0000 0000 JOO000 
DC D'5.4E-79' 0010 O1D1 33A9 49F6 
DC D‘7.2E+75' 7FFE BOE3 AD97 8760 


In the internal representation of floating point constants, the 
fractional part can consist of from 1 to 6 hexadecimal digits for 
single precision, and up to 14 hexadecimal digits for double 
precision. If the decimal number exceeds this degree of 
accuracy, the magnitude of the number is’ preserved but the 
precision is lost. In performing the conversion from decimal to 
internal floating point, CAL/32 carries guard digits to ensure 6 
hexadecimal digit accuracy for single precision and 14 
hexadecimal digit accuracy for double precision. The programmer 
must ensure proper alignment. 
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3.8.2.7 Character Constants 


Character constants consist of the single letter code C followed 
by a string of ASCII characters enclosed in apostrophes. All 
characters are translated into 7-bit ASCII, in which the most 
Significant bit is always 0. Examples of character constants 
are: 


DC C'NAME ' 
DC C'APOSTROPHE = '' ! 


The second example shows how an apostrophe is included in a 
character constant. Between enclosing apostrophes, a double 
apostrophe is treated as a single character. The maximum number 
of characters that can be defined in a single character constant 
is 64. If the number of characters in a constant is odd, CAL/32 
appends a blank character at the end to maintain halfword 
alignment. 


3.8.2.8 Decimal String Constants 


The source format for decimal string constants consists of a 
decimal number enclosed in apostrophes and preceded by the letter 
P for packed decimal string constants, or by the letter U for 
unpacked decimal string constants. The decimal number is an 
integer and consists of an _ optional plus sign or minus sign, 
followed by 1 to 31 decimal digits. 


The machine internal representation of the packed decimal string 
constant is a fixed point, sign-coded integer, where each digit 
occupies 4 bits and each byte holds 2 digits. That is, each 
decimal digit, O through 9, is binary encoded in a 4-bit 
hexadecimal digit. As the number of decimal digits varies from 
1 to 31, the length in bytes of the decimal string varies from 1 
to 16 bytes. The last hexadecimal digit contains a 4-bit code 
for sign; a hexadecimal C for plus, or a hexadecimal D for minus. 
The integer representation is right-justified within the variable 
length string, so the least-significant digit of the decimal 
number occupies the hexadecimal digit just preceding the sign 
code. Each digit is thus’ consecutively packed, with the 
most-significant digit (zero or nonzero) in bit positions 0 
through 3 of the leftmost byte of the string. See the examples 
that follow for the differences in internal representation, when 
the packed decimal string constant is defined by either the 
define constant (DC) instruction or the define byte (DB) 
instruction. 
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The machine internal representation of the unpacked decimal 
string constant is a fixed point, sign-coded integer, where each 
zoned digit occupies a byte. That is, each decimal digit, 0 
through 9, is encoded in 7-bit ASCII with the leftmost bit 0; 
providing an 8-bit byte with the left hexadecimal digit 
containing a zone code of 3 and the right hexadecimal digit 
containing the binary encoded decimal digit. As the number of 
decimal digits varies from 1 to 31, the length in bytes of the 
decimal string varies from 1 to 31 bytes. The integer 
representation is right-justified within the variable length 
string. The rightmost byte contains the least-significant digit 
in its rightmost hexadecimal digit and the sign code in its 
leftmost hexadecimal digit. Tne sign code is a 4-bit code, 
described above with a hexadecimal C for plus, and a hexadecimal 
D for minus. Each digit is thus consecutively coded into bytes, 
with the most-significant digit (zoned zero or zoned nonzero). 
See the following examples for the differences in internal 
representation, when the unpacked decimal string constant is 
defined by either the DC instruction or the DB instruction. 


The address of the string is the address of the leftmost byte 
containing the most-significant digit (zero or nonzero). The 
address generated for either the packed decimal string constant 
or the unpacked decimal string constant is that associated with 
the label of the source statements and the current LOC. Examples 
of the PDS constants are: 


INTERNAL 

. REPRESENTATION 
SOURCE FORMAT (HEXADEC IMAL) 
DB P'‘lL' LC 
DB P'+50' 050C 
DB P'-879' 879D 
DB P’+1234' 0123 4C 
DB P'-12345' 1234 5D 


DB P'1234567890123456789012345678901' 1234 5678 9012 3456 
7890 1234 5678 901C 


DE. P'a* oo01ic 
DC P'+50' 050C 
DC P'-879' 879D 
DC P‘'+1234' 0001 234C 
DC P'12345' 0012 345C 


DC P'1234567890123456789012345678901' 1234 5678 9012 3456 
7890 1234 5678 901C 
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Note that as string-processing instructions are intended to 
operate at the lowest addressable level, on byte-addressable 
locations these constants are most efficiently generated by the 
DB instructions, described in the define byte instruction 
section. If the DC instruction is used, an extra byte of leading 
zeros is generated, when the number of digits is a multiple of 4, 
or is an odd number of digits not divisible by 3. Examples of 
unpacked decimal string (zoned) constants are: 


INTERNAL 

REPRESENTATION 
SOURCE FORMAT (HEXADEC IMAL) 
DB U'l' Cl 
DB U'+50! 35C0 
DB U'-879! 3837 D9 
DB U'+1234' 3132 33C4 
DB U'12345' 3132 3334 D5 


DB U'1234567890123456789012345678901' 3132 3334 3536 3738 
3930 3132 3334 3536 
3738 3930 3132 3334 
3536 3738 3930 Cl 


De U'l' 30C1 

Dc U'+50' 35CO0 

DC U'-879' 3038 37D9 

DC U'+1234' 3132 33C4 

DC U'-12345' 3031 3233 34D5 


DC U'1234567890123456789012345678901' 3031 3233 3435 3637 
| 3839 3031 3233 3435 

3637 3839 3031 3233 

3435 3637 3839 30Cl1 


As string processing instructions require programmed length 


attributes, familiarization with the internal storage 
requirements for both packed decimal string and unpacked decimal 
string constants is advisable. In the previous examples, the 


relationship of number of digits to byte length is as follows: 


CONSTANT DEFINED BY BYTE LENGTH 
Packed DB (integer of n/2) + l 
Packed DC 2*(integer of n/4) + 2 
Unpacked DB n 

Unpacked DC n, for n even 


n+ 1, for n odd 


where n is the number of decimal digits in the source formats of 
the decimal constants. 
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3.8.3 Define Byte (DB) Instruction 


This instruction defines consecutive 8-bit bytes of data. It has 
the form: 
NAME OPERATION OPERAND 
A symbol DB One or more operands 
(optional) separated by commas 


The symbol used in the name field of the DB instruction is 
assigned the value of the current LOC. There is no automatic 
alignment. The programmer must ensure proper alignment where the 
symbolic name of a DB instruction is used as an operand 
identifier in an instruction requiring its operand to be located 
on a halfword, fullword, or doubleword boundary. 


The operand field can contain one or more operands, separated by 
commas. There can be an even or an odd number of operands. The 
operands can be any symbol or expression value. For any operand, 
other than character or decimal string expressions, the least 
significant eight bits of the operand value are used to generate 
one byte of data. Examples of the DB instructions are: 


DB x"F?7* 

DB 128 

DB = 

DB C'A' 

DB C'ABCDEFG' 


As shown in the examples, the operand of a DB instruction can be 
a signed integer. In this case, the integer can have any value 
between -128 and +127, inclusive. 


A special form of the DB instruction: 
DB * 


forces alignment of the LOC to a halfword boundary. If, when 
this instruction is encountered, the LOC contains an odd value, 
one byte of zero value is generated, and the LOC is made even. 
If the LOC is already even, this instruction has no effect. 
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3.8.4 Define List (DLIST) Instruction 


This instruction provides a simple means for defining circular 
lists used by the machine instructions: 


® Add to top of List 
@ Add to bottom of list 
e Remove from top of List 


@ Remove from bottom of List 


The define list instruction has the form: 


NAME OPERATION OPERAND 
A symbol DLIST. A previously defined absolute 
(optional) expression 


The absolute expression in the operand field specifies the number 
of slots in the list. For 32-bit assemblies, CAI./32 reserves 
four halfwords of storage for list pointers, followed by the 
specified number of fullwords (slots). The first halfword list 
pointer is initialized with a value equal to the number of slots 


in the list. The remaining three pointers are initialized to 
zero. For 16-bit assemblies, CAL/32 reserves four bytes of 
storage for list pointers, followed by the specified number of 
halfwords. The first byte pointer is initialized to a value 
equal to the number of slots in the list. The remaining byte 


pointers are initialized to zero. An example of the DLIST 
instruction is: 


LISTL DILIST 100 
In a 32-bit assembly, this has the same effect as: 


LIST1L DCF X'64',X‘O',X'O',X'O0' 
DS 400 


The DLIST instruction forces alignment to a fullword boundary in 
32-bit assemblies. It forces alignment to a halfword boundary 
for 16-bit assemblies. 
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3.8.5 Define Command (DCMD) Instruction 


This instruction causes the string within the set of apostrophes 
to be passed directly to the object code. 


NAME OPERATION OPERAND 
A symbol DCMD C'command string' 
(optional) 


The operand of the DCMD instruction is subject to the _ same 
syntactic rules as any other character string. CAL/32 performs 
no syntax checking on the command string. 


CAL/32 will generate the same object as in the past, provided the 
DCMD instruction is not used. The assembly of this’ instruction 
will produce an object that TET will reject. Link is required to 
process modules containing this extended object. The DCMD 
instruction is valid only ina Target 32 assembly and has no 
effect on the 16-bit object generation. 


3.8.6 Location Counter (LOC) Instructions 


These instructions allow the programmer to select the current LOC 
and set its value. For 32-bit assemblies, CAL/32 maintains three 
LOCs: pure, impure, and absolute. For 16-bit assemblies, it 
maintains two LOCs: relocatable and absolute. At any given 
time, only one LOC can be in use. With these instructions, the 
programmer can control the program segmentation and relocation. 


3.8.6.1 Pure (PURE) Instruction 


This instruction causes all subsequent machine instructions to be 
assembled as part of the pure segment. It has the form: 


NAME OPERATION OPERAND 
A symbol PURE None 
(optional) (ignored) 


The current LOC is saved, and the new LOC is set to point to the 
next halfword boundary beyond the most recently used location in 
the pure segment. If a PURE instruction occurs in a_ relocatable 
l6-bit program, it has no effect. If it occurs in an absolute 
l6-bit program, it causes a switch to the relocatable LOC. 
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3.8.6.2 Impure (IMPUR) Instruction 


This instruction causes all subsequent instructions’ to be 


assembled as part of the impure segment. It has the form: 
NAME OPERATION OPERAND 
A symbol IMPUR | None 
(optional) ! (ignored) 


The current LOC is saved, and the new halfword boundary is set 
beyond the most recently used impure address. In 16-bit 
assemblies, this instruction has no effect if the program is 
already in relocatable mode. If it is in absolute mode, the LOC 
is switched to relocatable. 


NOTE 


Uniess otherwise specified by the 
programmer, impure mode is assumed. 


3.8.6.3 Origin (ORG) Instruction 


This instruction sia a LOC and sets it to a defined value. 
It has the form: 


NAME OPERATION OPERAND 
A symbol ORG © A previously defined symbol or 
(optional) | expression 


The operand of the origin instruction determines which LOC is 
selected and the value it is given. If the value of the operand 
is pure, impure, absolute, or relocatable, the corresponding LOC 
is selected and set to the operand value. If the operand 
contains a forward reference, CAL/32 will perform any additional 
passes required to defilne all symbols. 


The user must guard against circular LOC dependency, as _ in_ the 
following example: 


ORG 

LIs 

A EQU 
LIS 

B EQU 
END 


x bw PD 
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CAL/32 will flag an "MOO1l xxxTOP" error, where xxx is PURE, IMP, 
or ABS depending on the current LOC. 


NOTE 


If mo ORG instruction appears at the 
beginning of a program, CAL/32 assumes it 
to be relocatable starting at relocatable 
zero. For 32-bit programs it also 
assumes the impure segment. 


3.8.6.4 Absolute (ABS) Instruction 


This instruction causes the LOC to be put in the absolute mode. 
It has the form: 


NAME OPERATION OPERAND 
A symbol ABS None 
(optional) (ignored) 


The current LOC is saved, and the new LOC is set to point to the 
next halfword boundary beyond the most recently used absolute 
location. If the absolute LOC was not previously used, it is set 
to zero. 


3.8.6.5 Align (ALIGN) Instruction 


This instruction conditionally aligns the current LOC to the next 
highest value that is divisible by the specified operand. It has 
the form: 


NAME OPERATION OPERAND 
A symbol ALIGN A symbol or 
(optional) expression 


The value contained in the operand field determines the type of 
alignment. Symbols used in the operand field must be previously 
defined. The value in the operand field must be absolute and 
equal to either 2, 4, 8, 16, etc. (power of 2). If the operand 
value is 2, CAL/32 adjusts the LOC to ensure that it contains a 
halfword address. CAL/32 forces fullword alignment if the 
operand value is 4, and doubleword alignment if the value is 8. 


3-50 48-050 FOO RO1 


If at the time of this instruction the LOC 
is already properly aligned, CAL/32 does not change it. Tf it 
is not properly aligned, CAL/32 increments it by the minimum 
amount necessary to force proper alignment. A symbol, if used in 
the name field, receives the value of the LOC after the alignment 
is performed. 


NOTE 


If the value of the operand is not 
absolute, or if it is not correctly 


Gefined,  $$CAL/32 forces fullword 
alignment, and generates an error 
message. , 


3.8.6.6 Conditional No Operation (CNOP) Instruction 


This instruction is similar to the ALIGN instruction in that it 
conditionally aligns the LOC to a power of 2. It has the form: 


NAME OPERATION OPERAND 
A symbol CNOP | A symbol or 
(optional) | expression 


The CNOP differs from the ALIGN instruction in that instead of 
merely incrementing the LOC, it actually inserts no operation 
instructions into the program stream. The value of the operand 
must be absolute and equal to a power of 2. Symbols used in the 
operand field must have been previously defined. If at the time 
this instruction is encountered, the LOC is on an odd boundary, 
CAL/32 increments it by one to make it even, inserts the required 
number of CNOP instructiions to force alignment, and generates an 
error message. This instruction has no effect if the LOC is 
already properly aligned. A symbol, if used in the name _ field, 
receives the value of the LOC associated with the first CNOP 
instruction generated. 
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3.8.7 Assembler Control Instructions 


These instructions allow the programmer to control the assembly 
process itself, identify the type of processor on which the 
program is to be run, halt the assembly operation temporarily, 
and request a limited amount of optimization. 


3.8.7.1 Target (TARGT) Instruction 


This instruction identifies the type of processor on which the 
program is to be run. It has the form: 


NAME OPERATION OPERAND 
A symbol TARGT A symbol or 
(optional) expression 


The value of the operand expression must be either 16 or 32, 
absolute. Symbols used in the operand field must be previously 
defined. If the operand value is 16, CAL/32 generates object 
code for 16-bit processors. If the value is 32, it generates 
object code for 32-bit processors. If the value is anything 
else, CAL/32 generates a warning message and generates code for 
the same type of processor on which it is running. If there is 
no TARGT instruction in the program, CAL/32 assumes the target 
machine to be the same as the machine on which the assembly is 
running. 


NOTE 
The TARGT instruction must precede any 


PURE or IMPUR instructions or any 
instruction that generates machine code. 


3-52 48-050 FOO ROL 


3.8.7.2 End (END) Instruction 


The END instruction indicates the end of the source input. It 
has the form: 


NAME OPERATION OPERAND 


A symbol END A symbol or 
(optional) expression (optional) 


Because of its function, this statement must be the last 
instruction in the source input file. The optional operand, if 


used, identifies the starting location of the program. For 
example: 

MAIN EQU * 

LAST END MAIN 


The END instruction, with the operand MAIN, causes CAL/32 to 
output information identifying the location MAIN as the starting 
location of the program. The loader and the operating system use 
this information to ensure that the program starts at the 
requested location. If there is no operand, the END instruction 
merely terminates the assembly process without outputting any 
loader information. The END instruction is required in all 
CAL/32 programs. 


3.8.7.3 Copy Library (CLIB) Instruction 
This instruction allows the user to specify or change library 
files from within a program. It has the form: 


CLIB vol: fname.ext 


Each CLIB statement logically concatenates the new library file 
(operand of CLIB) to any existing library file. If the new 
library file cannot be assigned, CAIL/32 will log an error message 
and pause. 
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3.8.7.4 Copy (COPY) Instruction 


This instruction allows the programmer to insert source code from 
library files into the source code received from the regular 


source input file. It has the form: 
NAME OPERATION OPERAND 
A symbol COPY A symbol[,vol:fname.ext] 
(optional) (required) 


CAL/32 assumes that the library file was assigned to lu7 (see 
Appendix A). CAL/32 also assumes that the file is made up of 
80-character records. It searches through the logical file, 
looking only at the first 10 characters of each record until it 
finds a file label of the form: 


RECORD POSITION CONTENTS 
l and 2 => 
3 through 10 A valid symbolic name of 


from 1 to 8 characters 


in which the symbolic name exactly matches the symbol in the 
operand field. If the search is unsuccessful, CAL/32 logs the 
message: 


COPY ERROR: XXXXXXXX 


in which xxxxxxxx is replaced by the name of the file being 
sought. This might happen in the case of incorrect file 
assignment. The operator can change the assignment and resume 
the assembly process from the location of the COPY instruction. 
The COPY instruction allows only one _ operand. The programmer 
rust provide one COPY instruction for each file to be copied into 
the source stream. 


If the optional second operand is supplied, CAL/32 will assign 
and search only that physical file and ignore any files logically 
attached by CLIB. If the file cannot be assigned, CAL/32 will 
log an error message and pause. 


The copy process terminates when an END statement is encountered 
in the file, or when a record with either /* or /& in the first 
two character positions is encountered. Where an END instruction 
is encountered in the copy file, it does not mean the end of the 
source file but only the end of the copy file. At this point, 
CAL/32 resumes reading from the source input file. COPY 
instructions may not appear in files which are themselves being 
included in a source program by means of a COPY instruction. 
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3.8.7.5 File Copy (FCOPY) Instruction 


The assembler instruction FCOPY allows the user to copy an entire 
library file. It has the form: 


FCOPY vol: fname.ext 


When FCOPY is in effect, a /* starting in column 1 or an END in 
the opcode field will be skipped, and copying will continue until 
an end of file is _ | reached. If the file cannot be assigned, 
CAL/32 will log an error message and pause. 


3.8.7.6 Pause (PAUSE)/| Instruction 
The PAUSE instruction allows the programmer to halt the assembly 


process. It has the form: 


NAME OPERATION  OPERAND 


A symbol PAUSE None 


(optional) | (ignored) 


The PAUSE instruction Lcapoeabiiy halts the assembiy process. 

When the assembler encounters a PAUSE instruction, the assembler 
requests the operating system under which it is running to 
suspend execution. The system notifies the operator. The 
operator can resume execution of the assembler at the instruction 
immediately following the PAUSE instruction by using the 
operating system command CONTINUE. For example, the PAUSE 
instruction can be used by the operator to reassign a copy file, 
such as: 


COPY REGEQUS COPY REGISTER EQUATES 


PAUSE 
COPY COMBLKS COPY COMMON BI.OCKS 


3.8.7.7 Squeeze (SQUEZ) Instruction 

The SQUEZ instruction ‘puts CAL/32 into a mode in which it 
performs a limited amount of space optimization. It has the 
form: : 


NAME OPERATION OPERAND 


A symbol SQUEZ A symbol or 
(optional) expression (optional) 
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When in optimization mode, CAL/32 makes multiple passes over the 
source input. During each pass, it attempts to reduce long 
instructions (48 and 32 bits) to shorter forms (32 and 16 bits). 
The value of the operand expressions sets the maximum number of 
passes. If CAL/32 can complete the optimization in fewer passes, 
it stops the optimization process and completes the assembly. 


The value of the operand expression must be an absolute number 
between 1 and 99. Any symbols used in the expression must have 
been previously defined. If the operand value is O, or if there 
is no operand, CAL/32 assumes a maximum of 9 passes. 


NOTE 


If there are user induced errors in the 
source stream (illegal mnemonics Or 
undefined symbols), CAL/32 terminates the 
squeeze operation and goes on to produce 


the final assembler output. Some 
instructions in this output may have been 
squeezed, depending on where inthe 


process the errors were discovered. 
CAL/32 performs three types of space optimization: 
1. Changes RX3 instructions to RX2 or RX1l 


2. Changes operation codes to allow the use of an _ equivalent, 
but shorter, instruction 


3. Eliminates unconditional branch instructions to the next 


halfword location 


An example of the first type of optimization is the forward 
reference instruction. In this instruction, the operand is 
defined in the program at some point beyond the instruction to 
which it refers. 


Example: 


A R1, VALUE 


VALUE DCF F*i2s* 
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When CAL/32 processes the ADD instruction, it cannot tell if the 
location of the second operand, identified by the symbol VALUE, 
is within the range of either an RX1 or RX2 instruction. It has 
to assume that an RX3 instruction is necessary. By making 
additional passes over the source input after all addresses have 
been resolved, CAL/32 has the needed information to determine if 
the reference to VALUB is within the range of either an RXl or an 
RX2 instruction and make the substitution. 


An example of the second type of optimization is: 


In the optimization mode, CAL/32 reduces this instruction to: 
LCS R3,1 


which reduces the length of the instruction from 48 bits to 16 
bits, without changing the effect. Depending on the processor, 
the substituted instruction might be faster or slower than the 
original instruction. | 


NOTE 
CAL/32 changes an operation code only in 
the object output. The original 
instruction remains in the listing, 


flagged with an asterisk. 


The third type of optimization does not occur in normal 
programming, but it does sometimes appear in compiler-generated 
CAL/32. For example: | 


ST R1l,SAVE 


B CONT INUE 


CONTINUE [IL Rl, TEMP 


In this case, CAL/32 simply eliminates the unnecessary branch 
instruction, although the branch instruction does appear in the 
assembly listing, flagged with an asterisk. 
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More than one SQUEZ instruction can appear in the program. The 
first SQUEZ instruction sets the number of additional passes. 
Subsequent SQUEZ instructions put CAL/32 back into optimization 
mode after a NOSQUEZ instruction (described below) took it out of 
the optimization mode. Operands may appear in the subsequent 
SQUEZ instructions, but they are ignored. 


Because CAL/32 looks at only one instruction at a time, and 
because its global data is limited to the symbol table, squeezing 
might introduce errors into the program. This is most likely to 
happen when data and instructions are mixed. 


Example: 
BTC 8,LOOP1 
LOOP 1 EQU m 
BFC 0, LOOP2 
DS 26 
ALIGN 4 
CONST DC F'256' 
LOOP 2 EQU > 


A 
. 


If on one pass, CONST is already aligned on a fullword boundary, 
the branch to LOOP2 can be converted to a short format branch. 
A subsequent pass may allow the branch to LOOP1 to be shortened. 
When this happens, CONST is no longer on a fullword boundary, and 
CAL/32 adds two to the LOC to align it properly. This forces 
LOOP2 out of the range of a short branch instruction. CAL/32 
will recover from this situation by changing the _ branch 
instruction back to its original format and marking it internally 
as unsqueezable. 
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3.8.7.8 Squeeze Related (NOSQZ, ERSQZ, NORX3) Instructions 


There are three additional instructions that can be used to 


control squeezing and optimization of the source input file. 
They have the form: | 


NAME OPERATION  OPERAND 


A symbol NOSQZ Not used 
(optional) (ignored) 
A symbol ERSQZ Not used 
(optional) (ignored) 
A symbol NORKX3 Not used 
(optional) (ignored) 


The no squeeze instruction (NOSQZ) has the effect of turning off 
the optimization processes initiated by a previous SQUEZ 
instruction. Optimization can be restarted by a_ subsequent 
squeeze statement. NOSQZ overrides a squeeze start option. 


The error squeeze instruction, (ERSQZ) can be used with the SQUEZ 
instruction. It forces CAL/32 to continue squeezing even after 
assembly errors are detected. 


The no RX3 instruction (NORX3) provides a simpler form of 
optimization during a normal 2-pass assembly. Once this 
instruction is encountered, CAL/32 forces RX instructions to. the 
RX1L or RX2 format. RX3 instruction formats are still generated 
if double-indexing is specified, or if the instruction references 
an element of a common, block or an externally defined symbol. 
This instruction can be safely used in programs that are smaller 


than 16kb. It must not be used in segmented (pure and impure), 
programs. | 


3.8.7.9 Sequence Checking (SQCHK, NOSEQ) Instructions 


The sequence checking instructions enable and disable the 
sequence checking of source. They have the form: 


NAME OPERATION OPERAND 


A symbol SQCHK Not used 
(optional) (ignored) 
A symbol NOSEQ Not used 
(optional) (ignored) 
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The sequence check instruction (SQCHK) causes CAL/32 to compare 
each source statement sequence number with the number of the 
preceding statement. Each successive number must be greater in 
the ASCII collating sequence than the preceding one. CAL/32's 
initial sequence value is equal to eight spaces, so that numbers 
can be right-justified in the field without leading zeros. If a 
source statement contains a value equal to or less than the 
preceding statement, CAL/32 generates an error message. The 
sequence fields of statements included in the program by a COPY 
instruction are not checked. 


The no sequence check instruction (NOSEQ) disables the sequence 
checking process. The sequence field of this instruction is 
checked, if sequence checking was in effect at the time. The 
default mode of CAL/32 is NOSEQ. 

3.8.7.10 Scratch (SCRAT) Instruction 


The scratch instruction causes CAL/32 to copy the source input 


file to a scratch device quring pass one. It has the form: 
NAME OPERATION OPERAND 
A symbol SCRAT Not used 
(optional) (ignored) 


Subsequent passes over the source input file are read from the 
scratch device. Since no statement preceding the SCRAT 
instruction can be copied, the SCRAT instruction should be _ the 
first statement in the program. 


3.8.7.11 Pass Pause (PPAUS) Instruction 


This instruction causes CAL/32 to issue a pause request to the 


operating system at the end of each pass. It has the form: 
NAME OPERATION OPERAND 
A symbol PPAUS Not used 
(ignored) (ignored) 


3-60 48-050 FOO ROL 


The purpose of the PPAUS instruction is to allow the operator to 
reset the source input file to the beginning for the next pass. 
This is useful in situations where no scratch file is available, 
and the source input file is not rewindable. 


NOTE 
Where neither the SCRAT instruction nor 
the PPAUS instruction is used, CAL/32 


issues a rewind command to the source 


input logical unit (lu) the end of each 
pass. 


3.8.7.12 Message (MSG) Instruction 


The message instruction allows the programmer to log a message to 


the system console. It has the form: 
NAME OPERATION OPERAND 
A symbol MSG. Text 
(optional) 
The operand field contains the text of the message. All 
characters following the operation field, up to and including 
position 71, are sent to the system console as a message. This 


instruction can appear anywhere in the program, and the message 
is logged on every pass. 


3.8.7.13 Batch Assembly (BATCH, BEND) Instructions 


The batch assembly instructions provide a means for assembling 


more than one complete program ina batch stream. They have the 
form: 


NAME OPERATION OPERAND 
None BATCH Not used 
(illegal) (ignored) 
None BEND Not used 
(illegal) (ignored) 
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The batch instruction (BATCH) initiates the batch stream. It has 
the effect of redefining the END instruction so CAL/32 does not 
terminate itself at the end of the required number of passes. 
Rather, CAL/32 terminates the assembly of that particular 
program, reinitializes itself, and starts reading the next 
program from the source input file. The BATCH instruction must 
be the first statement in the stream of programs. If it is used, 
CAL/32 assumes that there is a scratch device. Options specified 
in the operating system START command remain in effect for the 
entire batch assembly (see Appendix A). 


The batch end instruction (BEND) terminates the batch assembly. 
It must appear immediately following the END instruction in the 
last program of the stream. The BEND instruction tells CAL/32 to 
go to end of task when final assembly is completed. The end of 
task code returned is equal to the highest code generated during 
the batch assemblies. CAL/32 will also terminate a batch 
assembly normally if end of file or end of medium status is 
detected when attempting to read the first statement after the 
END of an assembly. 


3.8.7.14 Unreferenced Externals (UREX, NUREX) Instructions 
These instructions permit or suppress the output of object code 


for unreferenced externals. The default state is UREX. They 
have the form: 


NAME OPERATION OPERAND 
Not used UREX Not used 
(ignored) (ignored) 
Not used NUREX Not used 
(ignored) (ignored) 


3.8.8 Conditional Assembly Instructions 


These instructions allow the programmer to include code sequences 
in the program that may or may not be assembled, depending on 
some condition. By simply reassembling the program and 
redefining the conditions, a single program can be made to. serve 
more than one purpose. 
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3.8.8.1 Compound Condjit ional (IFx, ELSE, ENDC) Instructions 


There are three instructions in this set. They have the form: 

NAME OPERATION OPERAND 

A symbol IFx A symbol or 

(optional) expression 

A symbol ELSE A symbol or 

(optional) , expression 
(ignored) 

A symbol ENDC A symbol or 

(optional) expression 


(ignored) 


The compound conditional instructions are used to provide 
complete conditional assembly capability. A symbol used in the 
name field of an IF instruction is defined if the condition 
described by the instruction is true. A symbol used in the name 
field of an ELSE instruction is defined if the corresponding’ IF 
condition is false. Symbols used in the name fields of end 
condition instructions: are always defined. 


In the first instruction, the compound IF instruction, x 
represents the actual condition. Following is a list of the 
various mnemonics for these instructions: 


MNEMONIC MEANING MNEMONIC MEAN I NG 
IFZ If zero IFNM If nonminus 
IFNZ If nonzero IFE If even 
IFP If plus IFO If odd 
IFNP If nonplus IFU If undefined 


IFM If minus [FD If defined 


CAL/32 tests the value of the operand when processing compound [F 


instructions. If the operand meets the condition specified by 
the operation, the instructions immediately following the IF 
instruction are assembled. If the operand does not meet’ the 


specified condition, the instructions immediately following the 
IF instruction are not assembled. 


The ELSE instruction reverses the state of the assembler as set 
by a previous compound IF statement. If the assembler was not 
assembling code because a previous [F statement turned off the 
assembly process, the appearance of an ELSE instruction would 
cause the assembler to resume assembling, starting with the 
instruction immediately following the ELSE instruction. If the 
assembler was assembling code because a previous IF condition was 
met, the appearance of the ELSE instruction would cause _ the 
instructions immediately following the ELSE instruction not to be 
assembled. An ELSE . instruction is not required to appear ina 
block of conditionally assembled code. 


48-050 FOO ROL | 3-63 


The third instruction of this set is the end condition 
instruction (ENDC) which terminates the presently active 
condition. Normal assembly process resumes with the next 
instruction. Any compound IF _ instruction used in the program 
must have a corresponding ENDC instruction. If the end of the 
source file is reached before an existing condition terminates, 
CAL/32 terminates the condition, generates an error message, and 
resumes normal assembly on the next pass. If the operand of the 
IFx contains a forward reference, CAL/32 will perform any 
additional passes required to define all symbols. As an example 
of conditional assembly, consider a subroutine that can receive 
its parameters in either of two ways: first, the parameters are 
located by referencing a list of addresses immediately following 
the branch and link instruction in the main program; second, the 
address of the actual parameter list is contained in register 14. 
The subroutine could handle both of these situations with 
conditional assembly, as follows: 


IFZ CALI1 


SUB LH R1,O(RF) GET FIRST PARAMETER ADDRESS 
LH R1,0(R1) GET FIRST PARAMETER 
LH R2,2(RF) GET SECOND PARAMETER ADDRESS 
LH R2,0(R2) GET SECOND PARAMETER 
AIS RF ,4 ADJUST RETURN ADDRESS 
ELSE LIST NOT IN LINE 

SUB LH R1l,O(RE) GET FIRST PARAMETER 
LH R2,2(RE) GET SECOND PARAMETER 
ENDC 

RETURN BR RF RETURN TO CALLER 

If, at assembly time, the value of CALL1 is Zero, the 


instructions between the IF instruction and the ELSE instruction 
are assembled, and the instructions between the ELSE instruction 
and ENDC instruction are not assembled. If the value of CALL1 is 
other than zero, only the instructions between the ELSE 
instruction and the ENDC instruction are assembled. 
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Another example of 


be nested: 


* ERROR 1 


* ERROR 2 


LGTH 
ELSE | 
IFZ  SRC-DST 
ELSE | 
LHI R1,LGTH 
IFP SRC-DST 
LHI R2,SRC 
LHI R3,DST 
ELSE 
LHI R2,DST 
LHI R3,SRC 
ENDC | 
ENDC 
ENDC 


conditional assembly shows how conditions 


This set of nested conditionals depends on 


symbols: 


the comment: 


LGTH, SRC, and DST. 


* ERROR 1 


is produced. 


If LGTH is positive, 


the second comment: 


* ERROR 2 


is produced. 


If LGTH is positive, 


the following instructions: 


LHI R1,LGTH 
LHI R2,SRC 
LHI  R3,DSC 
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If LGTH is 


and SRC 


and SRC 


can 


CONDITION #1 
LGTH IS NOT POSITIVE 
CONDITION #1 
CONDITION #2 
SRC IS EQUAL TO DST 
CONDITION #2 


CONDITION #3 


CONDITION #3 


END CONDITION #3 
END CONDITION #2 
END CONDITION #1 


three 
only 


the values of 
negative or zero, 


LGTH IS NOT POSITIVE 


is equal to DST, only 


SRC [S EQUAL TO DST 


is greater than DST, 


are assembled. If LGTH is positive, and SRC is 


the following instructions are assembled: 


LHI R1l,LGTH 
LHI R2,DST 
LHI R3,SRC 


less than DST, 


The user must be careful, when using a forward reference in the 
operand field of the IFU instruction, to avoid the following type 


of code: 

IFU A 

B EQU 8 
ENDC 

A EQU 1 
IFNZ 8B 
DS 10 
ENDC 

B EQU 0 
END 


CAL/32 will flag this code with an "MOO1l xxxTOP" error where xxx 
is PURE, IMP, or ABS, depending upon the LOC used. 


NOTE 


A condition once set by an IF instruction 
remains in effect until the corresponding 


ENDC instruction is encountered. Thus, 

when the first condition was met, the 

first comment was’ produced. The ELSE 

instruction reversed this state, and no 

subsequent code was assembled. 
3.8.8.2 Simple If (IF) Instruction 
The simple IF instruction is retained in CAL/32 to maintain 
compatibility with previous assemblers. It has the form: 


NAME OPERATION OPERAND 
A symbol IF A symbol or 
(optional) expression 
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What CAL/32 does on encountering an IF instruction depends on the 
value of the operand. If the operand has a nonzero value, CAL/32 
assembles all statements following the IF instruction, until the 
end of the source file is reached, or until another MIF 
instruction is encountered in which the operand value is zero. 
At this point, CAL/32 stops assembling the source input until the 
END instruction, or another IF instruction with a nonzero operand 
value, is encountered. If the operand contains a forward 
reference, CAL/32 will perform any additional passes required to 
Gefine all symbols. 


NOTE 
Do not use simple IF instructions and 
compound IF instructions in the same 
program. Simple IF instructions must not 
be used in nested conditionals. 


3.8.8.3 Do (DO) Instruction 


The DO instruction provides a form of conditional and multiple 
assembly capability. It has the form: 


NAME OPERATION OPERAND 
A symbol DO A previously defined absolute symbol 
(optional) or expression 


The DO instruction causes the statement immediately following it 
to be assembled as many times as specified by the value of the 
operand. The value of the operand must be between 0 and 32,767. 
If the value of the operand is 0O, the next instruction is 
skipped. If the operand contains a forward reference, CAL/32 
will perform any additional passes required to define all 
symbols. 


The user must guard against circular LOC dependency, as in the 
following example: 


A EQU x 
DO B-A 
DS 2 

B EQU ~ 
END 


CAL/32 will flag an "MOO1 xxxTOP" error, where xxx is PURE, IMP, 
or ABS, depending upon the current LOC. 
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3.8.9 Instructions for Data Structures 

These instructions allow the programmer to define complex data 
structures. Some of these instructions allow the programmer to 
define and initialize data blocks compatible with FORTRAN common. 
3.8.9.1 Structure Definition (COMN, STRUC, ENDS) Instructions 


Structure definition instructions are used to define data 
structures. They have the form: 


NAME OPERATION OPERAND 
A symbol COMN Not used 
(optional) (ignored) 
A symbol STRUC Not used 
(optional) (ignored) 
A symbol ENDS Not used 
(optional) (ignored) 


The common instruction (COMN) defines FORTRAN compatible common 
blocks. The structure instruction (STRUC) defines other types of 
data structures. The end structure instruction (ENDS) terminates 
both common definitions and data definitions. 


The symbol in the name field of a COMN or STRUC statement 
contains the absolute value of the length of the structure or 
common block. The symbol specified with the ENDS instruction is 
associated with the current value of the offset counter. 


A symbol is always required in the name field of a COMN 
instruction. To define FORTRAN compatible blank common, a 
special symbol consisting of two slashes (//) must appear in the 
first two positions of the name field. The remaining positions 
must be blank. If the name field is blank, CAL/32 will assume 
(//) was intended for a FORTRAN blank common. 


The scope of the common block consists of all the _ storage 
definitions between the COMN instruction itself and the next ENDS 
statement. Only define storage, origin, and equate instructions 
are permitted between a COMN and its corresponding ENDS 
instruction. The define storage instructions included within the 
common block definition do not actually reserve storage; they 
define offsets within the common block. Origin statements can be 
used to modify the offset counter. The equate instructions’ can 
be used to define symbols’ relative to elements in the common 
block. Common blocks cannot be nested within other common blocks 
or within other structure definitions. 
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The following is an example of the definition of FORTRAN 
compatible common blocks: 


c FORTRAN PROGRAM 
INTEGER*2 1,J3,K,KK,K2,L 
COMMON A(10), I, J(3,20) 
COMMON/COMONE/B(30), K(4), KK 
COMMON /COMTWO/X,Y¥,Z,K2,1.(24) 


The CAL/32 code to def ine these common blocks is: 


// COMN DEFINE BLANK COMMON 
A DS 40 TEN FLOATING POINT NUMBERS 
I DS 2 ONE TWO-BYTE INTEGER 
J DS 120 SIXTY TWO-BYTE INTEGERS 
ENDS END OF BLANK COMMON DEFINITION 
COMONE COMN | DEFINE COMMON BLOCK COMONE 
B DS 120 THIRTY FLOATING POINT NUMBERS 
K DS 8 FOUR TWO-BYTE INTEGERS 
KK DS 2 ONE TWO-BYTE INTEGER 
ENDS ' END COMMON BLOCK COMONE 
COMTWO COMN DEFINE COMMON BLOCK COMTWO 
X DS 4. ONE FLOATING POINT NUMBER 
Y DS 4 ONE FLOATING POINT NUMBER 
Z DS 4 ONE FLOATING POINT NUMBER 
K2 DS 2 ONE TWO-BYTE INTEGER 
L DS 48 TWENTY FOUR TWO-BYTE INTEGERS 
ENDS 
Common block definitions must precede any statements that 
reference the common block. Referencing a common element plus a 
displacement is permitted in the operand of a machine 


instruction, in a define constant instruction, or ina block data 
Origin instruction defined below. 


STRUC is used to define general purpose data structures. The 
scope of this data structure consists of all the storage 
definitions between. the structure instruction and its 
corresponding ENDS instruction. Only define storage, origin, and 
equate instructions can be used ina Structure definition. ‘The 


define storage instructions do not actually reserve storage; they 
define offsets within the data structure. Origin statements~ can 
be used to modify the value of the offset counter. Equate 
statements can be used to define names relative to elements’ in 
the data structure. Data structures cannot be nested within 
other data structure definitions or within common block 
definitions. 
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To define a linked list structure, each node of which contains a 
2-byte forward pointer, a 2-byte backward pointer, six bytes, and 
a set of values such as: four bytes, one byte, one byte and six 
bytes, the programmer might write: 


NODE STRUC 
FWD DS 2 DEFINE FORWARD POINTER 
BAK DS 2 DEFINE BACKWARD POINTER 
VALA DS 4 DEFINE FOUR-BYTE VALUE 
VALB DS 1 DEFINE ONE-BYTE VALUE 
VALC DS 1 DEFINE ONE-BYTE VALUE 
VALD DS 6 DEFINE SIX-BYTE VALUE 
ENDS 


The effect of this definition is the same as: 


NODE EQU 16 
FWD EQU O 
BAK EQU 2 
VALA EQU 4 
VALB EQU 8 
VALC EQU 9 
VALD EQU 10 


Once NODE is defined, it can be used as follows: 


LHI R5, POOL GET ADDRESS OF POOL 

LB RO, VALB(R5) GET VALUE B OF FIRST NODE 

LH R5,FWD(R5) GET POINTER TO NEXT NODE 
POOL DS 100 *NODE 


Data structure definitions must precede any references to their 
elements in RX3 format instructions, unless the NORX3 instruction 
or the SQUEZ instruction was used. 
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3.8.9.2 Structure Initialization (BDATA, BORG) Instructions 


Structure initialization instructions define FORTRAN compatible 
block data subprograms that consist of labeled common blocks. 
They have the form: | 


NAME OPERATION OPERAND 
A symbol BDATA Not used 
(optional) (ignored) 
A symbol BORG Not used 
(optional) (ignored) 


The block data instruction (BDATA) must precede any statements 
that generate data, and the block data subprogram must not 
contain any executable code. The common blocks to be initialized 
must be defined at the beginning of the block data subprogram. 
Once they are defined, the block origin instruction (BORG) is 
used to initialize the data elements of the common blocks. The 
operand of the block origin instruction consists of the common 
block name followed immediately by the element name or its 
displacement enclosed in parentheses. Only one operand is 
allowed. The following is an example of a block data subprogram: 


BDATA 
x 
x | COMMON BLOCK DEFINITION 
* 
BLK  COMN 
A Ds 4 
B DS 40 
¥ DS 20 
Z Ds 4 
ENDS 
* 
x INITIALIZE ELEMENTS A, B+8, AND Z 
* 
BORG BLK(A) REFERENCE BY NAME 
pe E'10' 
BORG BLK(64) REFERENCE BY DISPLACEMENT 
Dc E'20' 
BORG BLK(Bt8) REFERENCE BY NAME AND 
DISPLACEMENT 
Dc E'30' 
END 


This program initializes A to a floating point value of 10; Z to 
a floating point value of 20; and the third fullword, B, toa 
floating point value of 30. 
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3.8.10 Listing Control Instructions 


These instructions allow the programmer to exercise some control 
over the format and the content of the source listing produced by 
CAL/32 on the final pass of the assembly. . 


3.8.10.1 Listing Identification (PROG, TITLE) Instructions 
Listing identification instructions are used to force CAL/32 to 


print header information at the top of each page of the source 
listing. They have the form: 


NAME _ OPERATION OPERAND 
A symbol PROG Text 
(optional) 

A symbol TITLE Text 
(optional) 


The program instruction (PROG) specifies the primary heading for 
each page of the listing. In addition, it causes the symbol in 
the name field to be placed at the beginning of the object file 
for program identification. On 16-bit assemblies, only the first 
six characters of the name field are put in the object file. 


All characters in the operand field (a maximum of 56) up to. and 
including position 71 are printed in the primary header line of 
each page of the listing. If more than one PROG instruction is 
encountered in a module, the last PROG instruction will override 
all previous ones. , 


The title instruction (TITLE) is a way to specify subheadings 
that can be changed within the program. The text contained in 
the operand field up to and including position 71, is printed on 
the line immediately below the heading produced by the PROG 
instruction. As many TITLE instructions as required can appear 
in the source input file. Each time a TITLE instruction is 
encountered, CAL/32 starts a new listing page with the new 
subheading when the next printable statement is_ processed. 
Subsequent pages contain this same subheading, until another 
TITLE instruction appears. If two or more TITLE instructions 
occur together in sequence, only the last TITLE instruction 
affects the subheading content since a new page will be printed 
only when a printable statement is encountered. 


TITLE instructions themselves are not printed although they are 
included in the statement count. 
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3.8.10.2 Format Control (LCNT, EJECT, SPACE, WIDTH) Instructions 


Format control instructions allow the programmer to control the 
format of the listing. They have the form: 


NAME OPERATION OPERAND 


A symbol LCNT © A symbol or 
(optional) expression 
A symbol EJECT A symbol or 
(optional) expression 
A symbol SPACE A symbol or 
(optional) expression 
A symbol WIDTH A symbol or 
(optional) expression 


The operand field of the line count instruction (LCNT) specifies 
the number of lines to be printed on each page of the listing. 
The operand value must be an absolute number no greater than 99 
and no less than 10. The default value of the line count is 58. 


Whenever the eject instruction (EJECT) appears, it overrides the 
specified or default line count, and causes CAL/32 to start a new 
page when the next . printable statement is processed. The new 
page starts with whatever headings are in use. This statement is 
included in the statement count, but it is not printed. If one 
or more EJECT instructions occur together in sequence, only one 
page is advanced since the actual advance occurs only when a 
printable instruction is encountered. EJECT instructions 
themselves are not printed although they are included in the 
statement count. 


The operand field of the space instruction (SPACE) specifies the 
number of lines to be skipped in the listing. The value of the 
operand must be absolute. If the number of lines to be skipped 
exceeds the number of lines remaining on the page, this 
instruction has the same effect as an EJECT instruction and is 
included in the statement count, but not printed. 


The operand field of the width instruction (WIDTH) specifies the 
number of columns’ to be printed across the page. The value of 
the operand field must be an absolute number, not greater than 
132 and not less than 64. ‘The default value is 132. 
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3.8.10.3 Content Control (NLIST) Instructions 


The content control instructions control the content of the 


The list instruction (LIST) 
source statements are printed. 


listing. They have the forn: 

NAME OPERATION OPERAND 
A symbol NLIST Not used 
(optional) (ignored) 
A symbol LIST Not used 
(optional) (ignored) 
A symbol LSTC Not used 
(optional) (ignored) 
A symbol NLSTC Not used 
(optional) (ignored) 
A symbol ERLST Not used 
(optional) (ignored) 
A symbol LSTM Not used 
(optional) (ignored) 
A symbol NLSTM Not used 
(optional) (ignored) 
A symbol FREZE Not used 
(optional) (ignored) 
A symbol NFREZ Not used 
(optional) (ignored) 
A symbol CROSS Not used 
(optional) (ignored) 
A symbol NCROS Not used 
(optional) (ignored) 
A symbol LSTUR Not used 
(optional) (ignored) 
A symbol NLSTU Not used 
(optional) (ignored) 
A symbol WARN Not used 
(optional) (ignored) 
A symbol NWARN Not used 
(optional) (ignored) 


reverses 


The no list instruction (NLIST) suppresses listing of the 
program. 


situation, 
The assembler default is to print 


source 


and 


Only those statements that contain errors are printed. 


all 


all source statements. 


The list conditionals instruction (LSTC) permits 
unassembled conditional assembly statements. 
default mode of the assembler. 


printing of 
This is the normal 


The no list conditionals instruction (NLSTC) suppresses 
of unassembled conditional statements. 


printing 
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The error list instruction (ERLST) causes CAL/32 to print all 
assembly errors by type, along with the number of each statement 
on which the error occurred, immediately after symbol table 
listing. 3 


The list macro instruction (LSTM) permits printing of all macro 
expansions that are. part of the source input file. The macro 
instruction, the expanded source code, and the generated object 
code are printed. A plus character (+) precedes each statement 
number in the expanded source to identify those statements as 
part of a macro. Tats is the normal mode of the assembler. 

The no list macro instruction (NLSTM) suppresses) printing of 
macro expansions. Only the macro statement itself is printed. 


The freeze (FREZE) instruction halts incrementing of the 
statement counter when a copy file or macro expansion are 
included in the source input file. All statements in the _ copy 
file or macro expansion receive the same statement number as that 
of the COPY instruction. This is the normal mode of the 
assembler. : 


The no freeze (NFREZ) instruction increments the statement 
counter for every statilement encountered in the source input. 


The cross reference (CROSS) instruction uses CAL/32 to generate 
and print a cross reference listing of all the symbols used in 
the program. Each symbol is listed in alphabetical order, along 
with identification of the statements in which it is referenced. 
The statement in which it is defined is flagged with an asterisk. 
This is the normal mode of the assembler. 


The no cross (NCROS) instruction prevents the generation of a 
cross reference listing. 


The list unreferenced symbols (LSTUR) instruction causes 
unreferenced symbols to be listed in the symbol list. This is 
the normal mode of the assembler. 


The no list unreferenced symbols (NLSTU) instruction suppresses 
the listing of unreferenced symbols in the symbol list. 


The warning (WARN) instruction allows CAL/32 to flag warnings’ in 
the iListing and tally the number of warnings encountered. This 
is the normal mode of the assembler. 


The no warning (NWARN) instruction suppresses both the warnings 
and the warning count from the Listing. 
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3.8.11 Auxiliary Processing Unit (APU) Option 


The APU and NAPU start options and the APU and NAPU_ pseudo 
instructions turn the APU option on or off. The APU and NAPU 
start options override the corresponding APU and NAPU_ pseudo 
instructions. If more than one APU or NAPU option appears ina 
START option, the latest option takes precedence. The default 
for this option is off. 


I— Svc, WCS, or non-APU instructions are encountered when the APU 
option is on, their occurrences are flagged in the listing by the 
carat character (A) as CAL warnings which have no affect on the 
end of task code. When tne APU option is in effect for each 
program containing SVC, WCS, or non-APU instructions, CAL/32 
automatically generates and inserts one or more DCMD commands 
inte the object code. The text of these DCMD commands is: 


"xx**x MODULE XXXX CONTAINS SVC INSTRUCTIONS" 
"xxx*xx* MODULE XXXX CONTAINS WCS INSTRUCTIONS" 
"x%**x* MODULE XXXX CONTAINS INSTRUCTIONS ILLEGAL FOR APU" 


XXXX | represents the name of the program. 


3.9 ASSEMBLY LISTING 


The assembly listing consists of two sections: the source’ and 
object program statements and the symbol cross reference table. 
Tne format for printing the source and object program statements 
is basically the same for either 16-bit assemblies or 32-bit 
assemblies. The only difference is in the number of characters 
printed for the LOC and the object data. 


e In 16-bit assemblies, only four hexadecimal digits are printed 
for the LOC, and a maximum of eight hexadecimal digits for the 
data. The letter R is appended to the LOC value if the 
relocatable LOC is being used. 


e In 32-bit assemblies, six hexadecimal digits are printed for 
the LOC and a maximum of 12 hexadecimal digits for the object 


data. In addition, the actual second operand address of RX2 
and SF instructions is printed next to the object data. This 
address is preceded by an equal sign (=). The letter I is 


appended to the LOC if the impure LOC is being used. The 
letter P is appended to the LOC if the pure LOC is being used. 


e In both 16- and 32-bit assemblies, the letter F is appended to 


the data field to indicate that the statement references’ an 
externally defined symbol, a symbol in a common block, or an 
undefined symbol. 
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The statement number is a decimal number between 1 and 99,999. 
Each source statement read by the assembler is assigned a 
unique statement number, beginning with 1, except for source 
statements from a copy file or macro expansion with the FREZE 
instruction. The first column of the listing can contain any 
of the following characters: 


CHARACTER : MEAN ING 


! The name field of this instruction contains a 
symbol that was redefined by an EQUATE 
instruction. 


ig A mach ine instruction not available on the 
target machine was used; an operand that was 
improper existed and was substituted, or 


a machine dependent instruction was used in 
assembling a common but could be assembled, or 


an assembler instruction was used with an 
operand that was improper but could be 
assembled, or 


a SCRAT card was encountered as other than the 
first statement or when batch mode is. in 
effect, or 


an _ EXTRN/ENTRY symbol is longer than 6 
characters for target 16, or 


a DS instruction was encountered in a _ pure 
section. 


* A machine’ instruction was shortened or 
modified by squeezing. 


Nn The APU option is in affect, and the 
instruction on this line is an SVC 
instruction, a WCS instruction, Or an 


instruction illegal for an APU. 
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The following information is printed at the beginning of the 
cross reference listing: 


e Start options in the START command 


e The number of errors detected by the macro processor if the 
program assembled was generated by the macro processor. 


@e Number of CAL/32 errors and the page number of the last error 


@e Number of CAL/32 warnings and the page number of the last 
warning 


@® Number of passes 
@ Message indicating the use of symbol table paging to disk 


@ Message indicating abnormal termination of squeezing because 
of squeeze-induced errors 


@ Message indicating the amount of required table space 


Following this, each symbol used in the program is listed in 
alphabetical order along with its value. If a cross reference 
was requested, the statement number of each statement containing 
a reference to the symbol is printed following the value. The 
statement number in which the symbol is defined is printed with 
an asterisk (*) following. Associated with each symbol is a flag 
used to indicate one of the following: 


FI.AG MEAN I NG 

3) Properly defined local symbol 
M Multiply defined symbol 

U Undefined symbol 

< Entry symbol 

<0 Undefined entry 

> Externally defined symbol 

>»M Multiply defined external 

as Unreferenced external 


The flag is printed in the first column of the line containing 
the symbol. 
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If an error is detected in a source statement, the following 
message is printed immediately after the error statement: 


xx Annn xx 


A indicates the general type of error, and nnn is a decimal 
number that further identifies the error. Appendix A contains a 


complete list of CAL/32 error codes. 
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: CHAPTER 4 
COMMON MODE PROGRAMMING 


4.1 INTRODUCTION 


A useful feature of Common Assembly Language/32 (CAL/32) is 
common mode programming where a single source file can be used to 
produce object code for either 16- or 32-bit processors. In 
creating a common mode source file, the programmer must be aware 
of certain restrictions and safeguards and, in some cases, must 
use special operation mnemonics that can be translated into 
either 16- or 32-bit operations. 


4.2 ADDRESS OPERATION INSTRUCTIONS 


Addresses for 16-bit processors occupy 16 bits, a halfword. For 
the 32-bit processors, addresses occupy the least-significant 24 
bits of a fullword. Im normal mode, CAL/32 makes no distinction 
between operations on address quantities and operations on other 
data types. However, when writing in common mode, the programmer 
must use special operation mnemonics for address operations’ so 
CAL/32 can translate them into the correct target machine code. 
Table 4-1 lists these instructions, their mnemonics, and the 
target machine translations. 


TABLE 4-1 COMMON MODE ADDRESS OPERATIONS 


| 32-BIT |} i 
! | : ! TRANS- | TRANS- | 
H INSTRUCTION | MNEMONIC ; LATION }; LATION |} 
H Se See ne no et ee pe ST ter ae en ete eat fe a ae se om am gtr ee nT et ae ae me gt oe et ae et os ey oe oe ae er oe oe ee eae cea ae ce eo ee ce ee | 
| Add address | AA i A | AH 
| Add address immediate AAI | Al | AHI 
| Add address RR AAR i AR |} AHR H 
| Add address to memory AAM | AM ; AHM { 
i Compare address H CA : |} CH H 
| om oe em th A hm lh ot ee ae en nt ee te Sm mf Sm AR a ma H 
i Compare address immediate CAI i; CI i CHI 
| Compare address RR © H CAR i CR i CHR 
| Compare logical address CLA i cL {| CILH 
| Compare logical address 
; immediate H CLAI ; CLI | CLHI H 
! Compare logical address RR CLAR { CLR { CLHR | 
; Immediate : i CLAI ; CLI ;} CLHI H 
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TABLE 4-1 COMMON MODE ADDRESS OPERATIONS (Continued) 


‘wntel ote sr eel eras SRO cme sera in AE gee aes oa San me omy SN NE Ce per ey NL MME arm a SEE eet cee tem ee ems oem er eet my ee a MOD NY a Ne 


INSTRUCTION } MNEMONIC | LATION } LATION } 

Load wave sa H LDA i o-G i LH { 
Load address immediate H LDAI ; LA | LHI { 
Load address RR | LDAR i LR | LHR { 
AND address \ NA i N } NH H 
AND address aEHNE DALE H NAI ; NI { NHI H 
ssa i cis «Smog a om <A i’ see "mim it hr”. i! nt’ ni’ Tea’ mins am iti lg cle nuit cw eas Cs m/e» a “cs eet Sin ws’ “ol in ‘ob i 
AND address RR H NAR 1 NR i NHR 1 
OR address H OA i; oO { OH i 
OR address immediate i OAI ; OT | OHI i 
OR address RR ! OAR ; OR i OHR H 
Subtract address H SA ; § i SH H 
i ec ee i i ae raat Eat se ei ela A a alah mh ly a H 
Subtract address immediate H SAI { SI | SHI { 
Subtract address RR | SAR | SR i SHR H 
Shift left address arithmetic | SLAA ; SLA i SLHA jj; 
Shift left address logical i SLAL i SLL { SLHL ;{ 
onEae right aeOrene: See chmet te H SRAA i SRA | SRHA_ ; 
WP in Sy et, ae ye me Oy N erg pp ny EE RP OMS GT in ee yyy ORT OTe Me re Ee heey a SAO Ge En [y LUD eet eR, gt H 
Shift right addeeoe og ical 1 SRAL ' SRL i SRHL | 
Store address H STA i ST | STH H 
Test address immediate H TAI i TI i THI 
Exclusive OR address i XA i xX i XH 
Exclusive OR address immediate | XAI i XI ; XHI | 
Hi eatadaealianeiethceieatieetandiaeientenantcetiiatnaietant attested entet cctentantaciendeianteti en ianttenomtentantaet ete atateatedenentmtetedon Sil ashe “Sie See oes le H 
Exclusive OR address RR | XAR ; XR | XHR { 
Multiply address H MA i M | MH 
Multiply address RR i MAR | MR | MHR H 
Divide address ' DA i D ; DH H 
Divide address RR H DAR i DR ; DHR { 


eC A re Nene SL A A NO Sg SU RO SF Sem meme eet SO eee uty REO arene em Sm Nem ee Neem nel ge mem Ge ees SY SO ee com EEE ge YU SRE OR cranes om ao nae He tee me 


CAL/32 


instructions, depending on the target machine. 


ADDL 
DISP 


translates 


DC 
DC 


these instructions into halfword or fullword 


R1,ADD1 
R1,DISP 


A( TABLE) 
2 


For example: 
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When CAL/32 assembles these instructions for 16-bit execution, it 
produces object code that would normally correspond to: 


LH = RL, ADD1 
AH —R1, DISP 


For 32-bit programs, CAL/32 produces code that would correspond 
to: | 


R1,ADD1 
R1,DISP 


oe 


Translation is at the object code level; CAL/32 prints the 
original common mode code on the listing. 


4.3 COMMON MODE IMMEDIATE OPERATIONS 


CAL/32 provides a common mode immediate operation for the _ load 
immediate LDI instruction. Depending on the target machine, the 
LDI is translated into a fullword-referencing LI instruction for 
the 32-bit machine, or a halfword-referencing LHI instruction for 
the 16-bit machine, as follows: 


- COMMON 32-BIT 16-BIT 


INSTRUCTION MNEMON I C TRANSLATION TRANSLATION 
Load Immediate | LD I II LHI 


4.4 COMMON MODE ASSEMBLER INSTRUCTIONS 


In addition to all of the regular assembler instructions 
described in Chapter 3, CAL/32 recognizes four assembler 
instructions primarily for use in common mode _ programming. Two 


of these are data definition type instructions; the other two are 
assembler control type instructions. 
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4.4.1 Data Definition Instructions 


The common mode data definition instructions are: define address 
length constant and define address length storage. They have the 
form: 


NAME OPERATION OPERAND 
A symbol DAC One or more operands 
(optional) separated by commas 
A symbol DAS A symbol or expression 
(optional) 


4.4.1.1 Define Address Length Constant Instruction 


The define address length constant instruction is equivalent to 


the define constant’ instruction. It is used in common mode 
programming to reserve storage to be initialized with address 
length constants. For 32-bit assemblies, the constants are 


fullwords aligned on fullword boundaries. For 16-bit assemblies, 
the constants are halfwords aligned on halfword boundaries. 


4.4.1.2 Define Address Length Storage Instruction 


The define address length storage instruction is equivalent to 


the define storage instruction. In 32-bit assemblies, the 
instruction reserves the specified amount of fullwords aligned on 
a fullword boundary. In 16-bit assemblies, it reserves’ the 


specified amount of halfwords aligned on a halfword boundary. 
Examples of the use of these instructions are: 


DAC A( TABLE ) 
DAS 16 


When assembled for 32-bit execution, the define address’ length 
constant instruction generates a fullword containing the address 
of TABLE. The define address length storage instruction reserves 
16 fullwords of storage. When assembled for 16-bit execution, 
these instructions cause CAL/32 to generate a halfword containing 
the address of TABLE, along with a storage area of 16 halfwords. 
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NOTE 
Def ine | address Length storage 


instructions can be used in common block 
and structure definitions. 


4.4.2 Assembler Control Instructions 


Two special assembler instructions control error checking. Their 
form is: 
NAME — OPERATION OPERAND 
A symbol. CAL Not used 
(optional) (ignored) 
A symbo 1 NOCAL Not used 


(optional) (ignored) 


The first of these instructions (CAL) establishes the common mode 
and enables common mode error’. checking. In this mode, any 
machine dependent instruction causes a nonfatal error, and a 
warning flag is printed on the assembly Listing. 


The NOCAL instruction|disables the common mode and its’ error 
checking mechanisms| until the next CAL instruction is 
encountered. This is|the assembler default mode in which an 
Operation code mnemonic, not valid for the targeted processor but 
for which there is a valid equivalent, is assembled using the 
valid equivalent. A question mark (?) is then printed in the 
left hand margin of the Listing. 


4.5 MIXED MODE COMPUTATIONS 


On 32-bit processors, mixed mode computations, such as adding a 
halfword quantity to an address length quantity contained ina 
register, can be performed. In general, any halfword arithmetic 
or logical operation can be performed on address’ length 
quantities contained in registers. The exceptions are: shifts, 
multiply, and divide. The halfword forms of these instructions 
should never be used with address length quantities. Instead, 
use the special addre$s operation instructions. 
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4.6 GLOBAL SYMBOLS 


The global symbols, ADC and LADC, are used primarily in common 
mode programming. In 32-bit assemblies, ADC has a value of four, 
the length in bytes of an address length constant. LADC has a 
value of two, the log (base 2) of the address length. In 16-bit 
assemblies, ADC has a value of two, and LADC has a value of one. 
Illustrated are these symbol uses in which a main program calls 
a subroutine and passes parameters to the subroutine ina list of 
addresses immediately following the branch and link instruction: 


BAL RF , SUB 
DAC A(PARM1) ,A(PARM2) ,A( PARM3 ) 
RETURN EQU ai 


The subroutine picks up the parameters and calculates the return 
address as follows: 


SUB AIS RF , LADC ADJUST RF FOR 
NAI RF , -ADC ALIGNMENT 
LDA R1,O(RF) ADDRESS OF FIRST PARAMETER 
LDA R2,ADC(RF ) ADDRESS OF SECOND PARAMETER 
LDA R3,2*ADC(RF ) ADDRESS OF THIRD PARAMETER 
SUBEND B 3* ADC (RF ) RETURN TO CALLER 


The add immediate short instruction and the add address immediate 
instruction are needed in the subroutine because alignment of 
address constants in 32-bit assemblies can cause a halfword of 
filler to be inserted between the branch and link instruction and 
the first address constant. In this case, the address. in 
register 15 is the address of this halfword, and these 
instructions increment the address in register 15 to make it 
point to the first address constant. If no filler is required, 
because the first constant is naturally aligned on aé_e fullword 
boundary, register 15 points to the first constant, and these two 
instructions have no effect. 
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Another use of LADC is in shift instructions where a byte pointer 
must. be converted into an address pointer, as: 


LB R1, INDEX GET BYTE POINTER 


SLAL R1,LADC CONVERT TO ADDRESS POINTER 
LDA i, GET ADDRESS FROM TABI.E 
BR R 


In 16-bit assemblies, LADC has a value of one, and the shift left 
logical instruction has the effect of doubling the value of the 
byte pointer, converting it into a halfword pointer. In 32-bit 
assemblies, LADC has a value of two, and the shift instruction 
has the effect of quadrupling the value of the byte pointer, 
converting it into a fullword pointer. 


The LADC symbol can also be used where machine dependent’ code 
must be written within a common mode program. For example: 


IFNZ LADC-1 IF NOT ZERO USE 32 BIT CODE 
L RF,A LOAD FULLWORD IN RF 

A RF ,B ADD FULLWORD B 

ST RF ,A STORE IN A 

ELSE LADC-~1 IS ZERO USE 16 BIT 
LM RE,A LOAD FULLWORD IN RE AND RF 
AH RF ,B+2 ADD LOW ORDER B 

ACH RE,B ADD HIGH ORDER B 

STM RB,A STORE IN A 

ENDC 


shows how fullword addition, requiring double registers in 16-bit 
assemblies and single registers in 32-bit assemblies, can _ be 
handled in a common mode program. 
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4.7 SPECIAL INSTRUCTIONS 


By definition, the instructions load multiple, store multiple, 
and load PSW, operate on address length data. This is why there 
are no address operation mnemonics for these instructions. Where 
these instructions are used in common mode programming, the data 
on which they operate must be defined by the define address 
length constant’ and the define address length storage 
instructions. For example: 


LPSW NEWPSW 


START STM RO, SAVE 
LM RO, PARAM 


NEWPSW DAC STATUS ,A(START) 
RSAVE DAS 16 
PARAM DAC CON1,CON2,... 


List processing instructions operate on address length quantities 
within the list. There is some incompatibility between the 16- 
and the 32-bit versions of these instructions. The 16-bit list 
instructions require byte pointers at the head of the list. The 
32-bit list instructions require halfword pointers. List 
instructions can be used in common mode programming as long as 
the number of slots in the list does not exceed 255. 
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Lists always should be defined with the define list instruction. 
Use byte instructions where it is necessary to refer to the list 
pointers in the program. Define displacement into the _ list 
pointer fields in terms of the LADC symbol. For example: 


SLOTS EQU CHL NUMBER OF SLOTS 


USED EQU 2*LADC-1 | NUMBER USED 

CTOP EQU 3*LADC-1 CURRENT TOP 

NBOT EQU 4*LADC-1 NEXT BOTTOM 
LB = R1, LIST+CTOP 

LIST DLIST 32. 


In this example, the Load byte instruction is used along with the 
value of CTOP to access the current top pointer in the list. 
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| CHAPTER 5 
COMMON ASSEMBLY LANGUAGE/32 
(CAL/32) OPERATING INSTRUCTIONS 


5.1 INTRODUCTION 


The CAL/32 assembler requires a minimum of one logical unit (lu) 
and up to a maximum of 11 logical units for operation, depending 
on the options selected and the features invoked by the source 
program. All of these logical units can be assigned by the user. 
However, if an lu is needed and not assigned, CAL/32 will 
allocate temporary system files for logical units 
4, 5, 6, 8, 9, 12, and .13. CAL/32 will delete and reallocate 
permanent files for logical units 2 and 3, provided they were not 
previously assigned and the DEL start option was specified. The 
logical units used are shown in Table 5-1. 


TABLE 5-1 CAL/32 LOGICAL UNITS 


} LOGICAL ; ALLOCATED ; 
LU } USE | RECORD j} BY CAL/32 | FOR 


ae ot ns oe ee oe 


Source input device. |} 80 No All 
The source input to be ; 
assembled is read from ; 
this device on_ pass | 
one. This device is re- |} 
wound prior to each | 
subsequent pass unless ; 
BATCH is specified and | 
the source input is not } 
on a random access j 
device, or Scratch H 
(SCRAT) or Pass Pause ‘ 
(PPAUS) is specified. 
J 
7 
H 
i 
H 
H 
H 
i 
i] 
i} 


108 T=16 
126 T=32 


If DEL 
specified 


Binary output device. All 
Assembled object pro- 
gram is written to this 
device on last pass. 

64 - 132 


If DEL All 


specified 


Assembly Listing output 
device. Assembly list- 
ing is written to this 
device on the last pass. 


wee eee ee ee we ee ee ee ew ee ee we ee we mw em ee ee em me ew we St 
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TABLE 5-1 CAL/32 LOGICAL UNITS (Continued) 


vem er me Arm A EER et terete ARLHS nem eu ree mR ae ee A eR meee ne Sr em eae re es ere em ee OR me tn Re Hom ome NN a eer nt ~ 


ALLOCATED | REQUIRED 
BY CAL/32 | FOR 


2 oe VSS we wee es ss ue atom or 


USE 


Source scratch device. 
The source input is 
copied to this device 
Guring pass one. The 
source input is read 
from this device on all 
subsequent passes. 


Symbol cross reference 
scratch device. Cross 
reference information 
is built on this device 
during the last pass. A 
device assigned to this 
lu must support random 
access. 


Symbol table paging 
device. Symbol table 
information is paged to 
this device during all 
passes. A device 
assigned to this lu 
must support random 
access. 


Source Library input 
device. Source inform- 
ation to be included in 
the main assembly is 
read from this device 
on each pass' unless 
SCRAT or BATCH was 
specified. Then the 
library is searched and 
read on pass one only. 


Forward equate scratch 
device. This lu can be 
used if forward refer- 
enced equates exist in 
the source input. This 
device must support 
random access. 


LOGICAL 
RECORD 


a ee ed 


80 


256 


512 


80 


256 


Yes 


Yes 


Yes 


No 


Yes 


|; SCRAT 


CROSS 


Insuff£i- 
cient 
memory 


COPY 


Forward 
equates 


ee ee a eee ee ee eee eee ee ee ee ee ee we oe 
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TABLE 5-1 CAL/32 LOGICAL UNITS (Continued) 


Co a ne Ey MRT 


Error 
their 


PCB 


re 
bo 


device 


13 


device 


en ee ee ee ee ee ee ee ee ee ee we ew ee we we we ww we : ae oe i 


i ee re ee Moen 


USE 


20 oe ee pee cee peer oe toe eee =e ee mee mow ee wee ae 
Se SN ET ST ee CT Get aan So re eet ee eee dae ee me ee me we an 


Error tabulation Bey ice: 
messages. and 
associated line 
numbers are 
binary to this device 
during the 
and written to 1lu3 
after completion of the 
assembly and symbol 
table listing. 


scratch device. . This 
must - support 
random access. 


PCB name 
scratch device. This 
must support 
random access. 


ne ee eT Met Cle Ma era _ 


ALLOCATED REQUIRED 
BY CAL/32 FOR 


2A SR Tm Sree Se seme ae yee ue coe oe oe ee oe ee eee ogee oe 
ao St SS a oe ae we Se ae aS ee Pt 


Yes ERLST 


H LOGICAL 


ow on 
i 
CH 
Q 

iS 
HC 
s) 


written in 


last pass 


directory 256 Yes CLIB 


directory } 256 Yes COPY 


ee me me ee eee ee ee ee ee ee oe ee oe oe oe ee ee oe we =e! 
oe eee ee we we we wee we ee ee we we we ee we ee oe ee we oe Hi 
wee ee ee ee ee ee eee ee we ee ee ee ee wee ee we wee we we we ; wo en 


eR ee ee ee eC ee eT ee ee i ee i ee a a i) 


When an assembly terminates, an end of task code is passed to the 


operating system 


in the operand field of the SVC 3 instruction. 


The meanings of the possible end of task codes are: 


END OF 
TASK CODE 


0 


1 
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MEAN ING 
Assembly complete without errors. 


Illegal option passed with the START command. 
Assembly is aborted after logging the illegal 
options to the console. The user should 
retry, 


One or more errors detected during the 
assembly. This end of task code is also used 
if errors are detected in one or more programs 
of a batch assembly. 


Misplaced BEND. 
Symbol table overflow. 
A cross-reference option problem. Try to 


reassemble or use the NCROSS option to turn 
off the CROSS option. 


5.2 COMMON ASSEMBLY LANGUAGE/32 (CAL/32) START OPTIONS 


When operating under 0S/32, CAL/32 accepts certain control 
options as arguments of the START command. The start options 
override assembler instructions and cause a carat (A) to appear 
in the first line of the listing. Any combination of spaces 
and/or commas can separate or follow the options specification: 


START 

OPTION OPERANDS 

APU None (Turns on APU warnings. ) 

NAPU None (Turns off APU warnings. ) 

BATCH None 

CAL None 

NOCAL None 

CROSS None 

NCROS None 

DEL None 

NDEL None 

ERLST None 

ERSQZ None 

FREZE None 

NFREZ None 

LCNT Lines per page (10-99) 

LIST None 

NLIST None 

LsTc None 

NLSTC None 

LS'TM None 

NLSTIM None 

LSTUR None 

NLSTO None 

NDISK None (Inhibits symbol table paging to disk.) 

NFIX None (Prevents CAL/32 from making extra 
passes to fix squeeze induced errors.) 

NORXT None (Alias for NORX3.) 

NORX3 None 

NOSEQ None 

PPAUS None 

SCRAT None 

SOCHK None 

SQUEZ Number of passes (1-99) 

NOSQZ None 

TARGT 16 or 32 

OUREX None 

NUREX None 

WARN None 

NWARN None 

WIDTH Width of listing 


See Chapter 3 for an explanation of the assembler’ instructions 
that correspond to these start options. 
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Start options have the following form: 
option -operand 


A typical start command for a CAL/32 assembly with start options 
18: 


ST ,DEL,SQUEZ=99,NCROS 


The delete start options (DEL, NDEL) enable or disable CAIL/32 
from deleting and reallocating object and listing files when 
needed. If the DEL option is in effect and 1lu2 and 1u3 are 
unassigned, CAL/32 will delete, reallocate, and assign them to 
fname.OBJ and fname.tST, respectively. The default option is 
NDEL, in which case CAL/32 will simply log an 8100 error to the 
console and pause. If lul is not assigned to a direct access 
device, the DEL option will have no effect, and CAL/32 will issue 
an 8100 error before pausing. 


When CAL/32 encounters conflicting start options such as_ CROSS 
and NCROS, it will regard the last option encountered as the 


intended option. This allows the user to redefine the default 
start options via CSS. For example: 
LO CAL32 


AS 1,SOURCE.CAL 
ST ,NCROS DEL @1 
$EXIT 


The above command substitution system (CSS) effectively changes 
the default options to NCROS and DELETE unless overridden by the 
parameter @l. 
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5.3 OPERATING INSTRUCTIONS FOR ESTABLISHING COMMON ASSEMBLY 
LANGUAGE/32 (CAL/32) AS A TASK 


CAL/32 will not run on a 16-bit machine; however, it will still 
produce 16-bit object code if requested. 


Before using CAL/32 under OS/32, the relocatable object supplied 
must be established as an operating system task, using f.ink. A 
typical command sequence using Link to establish CAL/32 as a task 
is: 


LO .BG,IL.INK 


T .BG 
ST 
»ES ‘TA 


>OP work=5000, SYS=FFFFF, SEG,ROL 
>IN CAL32 

>»BU CAL32 

> END 


CAL/32 is segmented into pure and impure code for shared use with 
operating systems that support this capability. To establish 
CAL/32 as a nonsharable task, remove the SEG option from the 
above command sequence. 


When assembly is completed, CAL/32 terminates through the 
operating system, which logs this message: 


END OF TASK n 


where n specifies the end of task code. 


The files used for scratch, cross reference, paging, forward 
equates, PCB file directory, PCB name directory, and error 
summary will be allocated by CAL/32 as temporary operating system 
files if they are needed and were not previously assigned by the 
user. 
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5.3 OPERATING INSTRUCTIONS FOR ESTABLISHING COMMON ASSEMBLY 
LANGUAGE/32 (CAL/32) AS A TASK 


CAL/32 will not run ona 16-bit machine; however, it will still 
produce 16-bit object code if requested. 


Before using CAL/32 under O0S/32, the relocatable object supplied 
must be established as an operating system task, using Link. A 
typical command sequence using Link to establish CAL/32 as a task 
is: 


LO .BG,LINK 
T .BG 


>ES TA | 

OP work=5000, SYS=FFFFF, SEG,ROL 
>IN CAL32 

>BU CAL32 

>END 


CAL/32 is segmented into pure and impure code for shared use with 
operating systems that support this capability. To establish 
CAL/32 as a nonsharable task, remove the SEG option from the 
above command sequence. 


When assembly is completed, CAL/32 terminates through the 
operating system, which logs this message: 


END OF TASK n 


where n specifies the end of task code. 


The files used for scratch, cross reference, paging, forward 
equates, PCB file directory, PCB name directory, and error 
summary will be allocated by CAL/32 as temporary cperating system 
files if they are needed and were not previously assigned by the 
user. 
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APPENDIX A 


COMMON ASSEMBLY LANGUAGE/32 (CAL/32) ERROR CODES 


AOOL the address 
A002 the address 


A003 the operand 
BOO] alignment 
BOO2 alignment 
cool common mode 


DOO] Gata structure 


EOOL END placement 


FOOL missing operand 


FOO2 register 
specification 


F003 invalid source 
field 


FOO4 invalid symbol 
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The address is out of range for the 
specified instruction format. 


The address is out of range for an 
RX2 instruction. 


The operand of a previously squeezed 
instruction was changed making the 
squeezed instruction invalid. 


The address of the operand is on an 
incorrect boundary for the 
instruction specified. 


An odd address used ina T constant 
location counter (LOC) was not even 
when the instruction was specified. 


An opcode that is not part of the 
common mode set is used in a common 
mode assembly. 


An illegal statement appears in a 
STRUC or COMN definition. 


An END statement was’ encountered 
within a STRUC or COMN definition or 
within an unterminated conditional. 


A required operand is missing. 


A register value is not in the 
range of 0 to 15, or an odd register 
value is used where an even value is 
required. 


Invalid label in the source field, 
a label in the name field is not 
followed by a space, or a required 
label is missing; e.g., on EQU. 


More than 8 characters were 
specified in a symbol. 


FOOS 


FO06 


FOO7 


FOO8 


FOO9 


FO10 


FO11 


FO12 


EXTRN 


immediate field 


ENTRY 


delimiter 


invalid expression 


apostrophe 


invalid operand 


improper statement 


An invalid type for EXTRN; e.g., 
common block, or EXTRN was used in 
an expression. 


The value of data is too large to 
fit into the immediate field. A 
fullword EXTRN is used in RIL 
instruction. A character string 
used as an immediate field is too 
long. 


A symbol declared as an ENTRY is 
undefined. Improper type for ENTRY; 
e€.g., common block name. 


Operands are not separated by 


commas. Unrecognizable operator. 
The last operand is not followed by 
a CR Or a blank. Unbalanced 


parentheses. Opcode is not followed 
by a space or a CR. 


Expression uses common element names 
not in the same block. 


No ending apostrophe in C,D,E,F, 
H,P,U,X, or Y constant. [llegal 
character encountered in 
C,D,E,F,H,P,U,X, or Y¥Y constant prior 
to the ending apostrophe. 


T constant was specified in TARGT 16 
assembly. Argument mode of T 
constant is not ABS, PURE, or 
IMPURE. Illegal data specified in 
BDATA program. Fullword EXTRN used 
as an operand of DCZ. Value of DB 
operand must be absolute. Value of 
DS, DSF, DSH. Invalid symbol used 
for ENTRY name. Symbol used as 
ENTRY must be ABS, PURE, IMPURE, or 
Relocatable. Invalid symbol used 
for EXTRN name. Invalid data in 
BORG. Operand of CNOP or ALIGN is 
not absolute. Operand of DLIST is 
not absolute. 


Improper type for EXTRN- operand; 
e.g., common block name. Transfer 
address on END statement is an 
improper type; e.g., EXTRN. Illegal 
operand on EQU. 
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FO13 


FO14 


FOLS 


TOOL 


MOO1 


MOO02 


oool 


POO1 


POO2 


ROOL 


Sool 


S002 


S003 


file descriptor) 
missing string 


invalid character 


conditional 


symbol definition 


s 


symbol def inition 
illegal opcode 
location counter 
reentrancy check 
relocation error 
sequence check 


COPY 


invalid option 
sequence 
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Syntax error on fd of a COPY, FCOPY, 
or CLIB statement. 


No characters between apostrophes of 
C,E,D,F,H,P,U,X or Y constant. 


Illegal character encountered 
between apostrophes of an E or D 
constant. 


An ELSE or ENDC statement'§ found 
without a matching IFx. 


The symbol in the name field is also 
used in the name field of another 


statement. The value or type of a 
symbol changed from its definition 
on a previous pass. (This can occur 


by illegal use of conditionals, ORG, 
DO, DS, or a misplaced SCRAT 
statement. ) 


An attempt was made to redefine a 
symbol with an EQU that is the name 
field of a statement. 


The opcode used is totally 
unrecognizable or illegal for the 
specified TARGT. 


The location counter exceeded 216 on 
a TARGT-16 or 224 on a ‘TARGT-32 
assembly. 


The instruction attempts to modify 
PURE code. 


An invalid combination of 
relocatabie terms in an expression. 
A relocatable operand follows a 


unary minus. 


The value in the sequence numbers 
field is net greater than the 
previous sequence number. 


COPY statement appears within a file 
being copied. An invalid symbol 
used as COPY operand. The operand 
of COPY is not followed by a space, 
comma, or CR. 


A COPY, PAUSE, MSG, or DO 
statement immediately follows a DO 
statement. 


$004 


$005 


TOO1 


TO02 


TOO3 


TO04 
uoOLl 


ud02 


u003 


U004 


U005 


invalid option 


PROG 


overf low 


floating point 


value 


divisor 
not used 


undefined symbol 


undef ined symbol 


An argument is not absolute or 
exceeds 32,767. An argument of LCNT 
is in the range of 10 to 99. An 
argument of WIDTH is not in the 
range of 64 to 132. An argument of 
TARGT does not evaluate to either 16 
or 32. An argument of SQUEZ is not 
in the range of 1 to 99. 


Multiple PROG statements were 
encountered in a program. 


The intermediate or final result of 
an arithmetic expression exceeded 
Ag & As 


An overflow occurred during 
conversion of floating point 
constant. 


The data item exceeds the range for 
specified type; e.g., X'12345". 


A division by 0 is attempted. 


A referenced symbol is not defined 
in the program. 


An attempt was made to circularly 
define a symbol; e.g.: 


A EQU B 
B EQU A 


File specified as an operand of 
FCOPY, CLIB, or COPY does not exist. 


Program name is not found in any of 
the PCB libraries. 
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: APPENDIX B 
PERKIN-ELMER OBJECT CODE FORMAT 


Modules in Perkin-Elmer object code format produced by Common 
Assembly Language/32 (CAL/32) are divided into records. Each 
record contains 126 bytes of information for 32-bit object code, 
or 108 bytes of information for 16-bit object code. The first 4 
bytes of each record of the object code format are organized as 
follows: 


pa RS ee a te ho cea Gs 4 4 Sei sbis pes vcetita ladon ct tha GS Gia Eats galvn Gages Sax tea ee ep ce yn he pave are 2S of b Se, Be rae eo ae ee 


H Sequence number H Checksum H 
Bits: 
0 15 16 31 


The sequence numbers are sequential negative integers -l, -2, -3, 
etc., represented in two's complement form. The first record in 
a program must have sequence number -1. Subsequent records must 
be in proper order to be loaded. 


The checksum is an exclusive OR sum of all halfwords’ in the 
record, except itself, exclusive ORed with a halfword of all 1's. 


The remainder of the record is a sequence of items; an item is a 


byte of loader information. There are two types of items: 
loader items and data items. Each loader item is followed by a 
certain number (which can be 0) of data items. The loader items 


and their meanings are Listed in Tables B-1l and B-2. 
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TABLE B-l 32-BIT LOADER ITEM DEFINITIONS 


Cee ee enn en eee ee ee eee Me eee, ee a ee ne ret Me ee ee er eM eC 


{| LOADER | 1 NUMBER OF DATA 
H ITEM | MEAN I NG H ITEMS FOLLOWING H 
se cee eee oe oe et me een a et ase a ge eae eee oa oe | 
0 | End of record | None 
1 i End of program i None 
2 | Reset sequence number i None 
3 | Block data indicator | 8-byte name, 
| 3-byte displacement, | 
H i ; any absolute data H 
! item (20-5B) 
4 } Absolute program address | 3-byte address 
5 | Pure relocatable program | 3-byle address 
| address 
6 | Impure relocatable program ; 3-byte address 
| address H 
7 | 2 bytes of pure relocatable | 2-byte address 
| Gata 
i 8 i 2 bytes of impure | 2-byte address i 
; relocatable data 
9 i 4 bytes of pure relocatable | 4-byte address 
| Gata H 
A ; 4 bytes of impure | 4-byte address 
| relocatable data 
B ; Common reference ; 8-byte address 
i | 3-byte displacement | 
H Cc i EXTRN | 8-byte name, fol- 
i i i lowed by item 4, H 
i 5, or 6 
H D | ENTRY | 8-byte name fol- 
H H ; lowed by item 4, | 
1 H { 5, or 6 
H E } Common definition | 8-byte name fol- H 
i lowed by a 3 byte 
i length 
H F | Program label | 8-character name 
H 10 i 3 bytes absolute and 3 i 6 bytes 
H | bytes pure relocatable H { 
11 | 3 bytes absolute and 3 | 6 bytes 
H | bytes impure relocatable H H 
12 | Load program transfer ; Item 4, 5, or 6 H 
13 | Define start of chain i Item 4, 5, or 6 
1 | (reference) { : 
L4 | Load chain definition i Item 4, 5, or 6 
| address 
L5 | 2 bytes absolute and 2 | 4 bytes H 
i bytes pure relocatable H H 
} 16 | 2 bytes absolute and 2 i 4 bytes 
\ i) | i 
| ( ' ' 


bytes impure relocatable 
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TABLE B-l 32-BIT LOADER ITEM DEFINITIONS (Continued) 


a a Sr ae re ee ae ce ane ee ane are mm fe mn 


LOADER NUMBER OF DATA 


| ITE { MEAN [NG I'TEMS FOLLOWING 
lore rr ee eee ee eee ee eee ee 
eee oe | Short form EXTRN | 8-byte name and 

i; Item 4, 5, or 6 

i 18 i Length of impure and pure | 3-byte impure length 
H | segments | and 3-byte pure 

{| Length 

1 L9 | Perform fullword chain | None 

i A i Perform halfword chain | None 

i 1B | No operation | None 

i le | 2-byle pure translation | 2 bytes 

; table address 

' ILD | 2-byte impure translation | 2 bytes 

i } table address H 

H LE i Not used i N/A 

i IF i l byte absolute data i lL byte 

; 20 i 2 bytes absolute data i 2 bytes 

r 21 i 4 bytes absolute data | 4 bytes 

i 22 | 6 bytes absolute data | 6 bytes 

i 23 | 8 bytes absolute data | 8 bytes 

1 { | 

P| : 

io is _—_ 

i 5B i 120 bytes absolute data | 120 bytes 

i 5C-64 {| Future use H 

i 65 i Extended EXTRN reference | 8-byte external 

; symbol name 

i | l-byte flag 

| ' i xXxxx xxO00 standard 
EXTRN 

H | ; XXXxX xXxOl weak 
EXTRN 

H i XXxXxX xxlO include 
H i { EX'LERN 

H : | 4-byte offset 

H : | Item 4, 5, or 6 

| 66 | Extended entry | 8-byte entry symbol 
{| l-byte flag 

} : i; Xxxx xx00O standard 
H } H entry 

: : i XXxXx xxOl data 

i ! entry 

| H | XXXxX xxlO weak 
entry 

: : i Item 4, 5, or 6 

i 67 i Link commands | 1l-byte length 

' i } 1-80 characters 

i i + of command 


Pm IN ee Nae NN fe Ne RN SUS A eNO me em am eee Sm mene Hoty YOY RE in La Sem come LUI SO rm, St Fam ee ee Ree na Ne a 
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mee eee ee ee eee ee a ee eee re ee ee ee eee 


TABLE B-2 16-BIT LOADER ITEM DEFINITIONS 


oe se ens Smt) rm ES ce ma ANE Sem eh MOT DN mt shane MND Dene oe em cm MD mR Sam cee Sm ne mum nme LE ee el em RT er Mim em nem UA mk mm Om nat tnt Se nem 


{| LOADER | { NUMBER OF DATA 
i ITEM | MEAN I NG | ITEMS FOLLOWING | 
| x2 ome SS ae ST Eee ee | 
{ 0 | End of record | None 
1 i End of program | None 
H 2 | Perform chain i None H 
H 3 | Toggle absolute/relocatable { None 
; mode : 
H 4 | Transfer address ; 2-byte address | 
5 | Load program address (ORG) {| 2-byte address | 
H 6 | Load reference address i 2-byte address | 
7 ' Load definition value | 2-byte address | 
H 8 | 2 bytes absolute data | 2 bytes data i 
i 9 {| 2 bytes relocatable data ; 2 bytes data H 
H A i 4 bytes absolute data | 4 bytes data H 
B | 2 bytes absolute and 2 | 4 bytes data i 
H i bytes relocatable data H 
C | EXTRN reference ; 6-byte name 
D i ENTRY definition | 6-byte name 
H E i Decode next item | Next item i 
{ EO | Declare common block i 6-byte name 
| 2-byte size 
El | Load common block | 6-byte name 
| GQefinition value | 2-byte offset 
i E2 i 2 bytes absolute block data {| 6-byte name 
| 2-byte offset 
{ 2 bytes data 
E3 i 4 bytes absolute block data {| 6-byte name H 
| 2-byte offset | 
{ i 4 bytes data 
i E4 | Reset sequence number to -1l {| None 
ES i 1 byte absolute data | 1 byte data 
E6 | L byte absolute block data {| 6-byte name 
| 2-byte offset 
| 1 byte data 
F | Program label Z 6- ayes name 


ee ee re ee eee a Sn ee i ee ee Eee ony 


All items are given in hexadecimal. 
a compound item whose’ interpretation depends 
follows. Item E and the following item are consider 
control item, however, 
This effectively allows more 
though most of them require only 1 nibble. 


ed a 


Note that item E is actually 
on the item it 
single 
and cannot be split across object records. 
than 16 different control items, 
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INDEX 


A t Circular LOC dependency 3-49 
3-67 
Absolute instruction 3-50 { Comment statements 3-1 
ADC. See address length | Common blocks 
constant. 1 FORTRAN compatible 3-68 
Add address immediate | Common instruction 3-68 
instruction 4-6 | Common mode 
Add immediate short | immediate operation 4-3 
instruction 4-6 | Common mode programming 4-3 
Address constants 3-39 |} 4-6 
Address. length constant 2-5 i Complex data structures 3-68 
Address length data 4-8 { Compound conditional 
Address operation H instructions 3-63 
instructions 4-1 i Compound IF instructions 3-63 
Align instruction 3-50 |; Conditional assembly 3-64 
Alignment | Conditional assembly 
doubleword 3-50 | instruction 3-62 
fullword 3-33 {| Conditional branch 
3-50 ; instructions 1-16 
halfword 3-33 | branch and link 1-17 
AND mask 1-16 {; Conditional no operation 
APU. See auxiliary i instruction 3-51 
processing unit. |} Constants 
Arithmetic expressions 2-1 i character 3-43 
Arithmetic operators 2-1 i decimal string 3-43 
Assembler control H hexadecimal 3-36 
instructions 4-5 H integer 3-37 
assembler control 3-52 { Content control instructions 3-74 
target 3-52 {| Copy file 3-54 
Assembler instructions 3-24 {| Copy instruction 3-54 
common mode 4-3 { 3-75 
Assembly listing { Copy library instruction 3-53 
source and object i Cross reference instruction 3275 
program statements 3-76 {| Cross reference listing 3-78 
symbol cross reference i Current location counter 3-3 
table 3-76 |} 
Assembly process H 
halting 3-55 -| D 
Auxiliary processing unit 3-10 | 
Auxiliary processing unit i Data definition instructions 3-31 
option 3-76 } common mode data 
{ definition 4-4 
i Data entry instruction 3-28 
B i Data structure instructions 3-68 
| DCMD command 3-76 
Batch assembly 3-62 { Decimal string constants 3-43 
Batch assembly instructions 3-61 | packed 3-43 
Batch end instruction 3-62 | unpacked 3-43 
Batch instruction 3-62 ; Define address length 
Block data instruction 3-71 | constant instruction 4-4 
Block origin instruction 3-71 | Define address length 
Branch and link instructions 1-17 3} storage instruction 4-4 
Branch instructions 1-4 i Define byte instruction 3-43 
H 3-46 
i Define command instruction 3-48 
Cc i Define constant instruction 3-34 
i 3-43 
CAL instruction 4-5 i Define list instruction 3-47 
CAL/32 start options 5-5 { 4-9 
Character constants 3-43 {| Define storage instruction 3232 
i 3-68 
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DO instruction 3-67 Header information 


1 
i] 
H printing of 3=72 
| Hexadecimal constant 3-36 
E i 
t 
Eject instruction 3-73 H I,J,K 
ELSE instruction 3-63 } 
End condition instruction 3-64 } I/O instructions 1-5 
END instruction 3-53 {| IF instruction 3-63 
End of task codes 5-4 i Impure instruction 3-49 
End structure instruction 3-68 | Include instruction anal 
Entry instruction 3-28 ; Instruction execution 
Equate instruction 3-24 | order of 1-4 
3-68 {| Instruction statements 
Error list instruction 3-75 | assembler a=] 
Error squeeze instruction 3+59 -| character positions s42 
Excess 64 notation 3-42 | fixed format 3-2 
Expressions H free format 3-2 
evaluation of 2-2 i machine 3-1 
Extended branch instructions 3-23 |} Instruction variations 1-17 
Extended branch mnemonics 3-22 { Instructions 
3-27 ;} absolute 3-50 
External instruction 3-28 |} add address immediate 4-6 
Externally defined symbols 3-30 |} address operation 4-1 
EXTRN. See external i align 3-50 
instruction. i assembler 3-24 
i assembler control 3-52 
H batch 3-62 
F i batch end 3-62 
i block data 3-71 
Field H block origin 3-71 
name 3-3 H branch on false 
operand 3=5 H condition short 3-23 
operation 3-4 H branch on true condition 
File copy instruction 3-55 {| short 3-23 
Floating point constants 3-41 |} CAL 4-5 
3-42 | common 3-68 
internal representation H compare 1-17 
of 3-42 | compound conditional 3-63 
Floating point registers i compound IF 3-63 
double precision 1-3 H conditional assembly 3-62 
single precision Le3 H conditional branch 1-16 
Format control instructions 3-73 conditional no operation 3-51 
FORTRAN blank common 3-68 3} content control 3-73 
Forward reference aoe ~l copy library 3-53 
Forward reference instruction 3-56 | cross reference 3-75 
Freeze instruction 3-75 | data definition 4-3 
{ Gata entry 3-28 
H data structures 3-68 
G H define address length 4-4 
{ define byte 3-45 
Global symbols { define constant 3-43 
ADC 4-6 i define list 3-47 
LADC 4-6 \ do 3-67 
i eject 3-73 
{ else 3-63 
H { end 3-53 
{ end condition 3-64 
Hardware H end structure 3-68 
register and immediate 1-8 { entry 3-28 
register and indexed ' equate 3-24 
storage L=7 i error list 3-75 
register to register 1-6 i error squeeze 3-59 
relocation 1-6 H external 3-28 
segmentation 1-6 H format control 3-73 
i forward reference 3-56 
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Instructions (Continued) 
freeze 


immediate short 

impure 

line count 

list conditional 

list macro 

list unreferenced symbols 
listing control 

listing indentification 
load immediate 

load multiple 

load PSW 


message 

no cross 

no freeze 

no list 

no list conditional 

no list macro 

no list unreferenced 
symbols 

no RX3 

no squeeze 

no squeeze check 

no warning 

NOCAL 

origin 

pass pause 

pause 

program 

pure 

register and immediate 

register and indexed 
storage 

register to register 

scratch 

sequence check 
simple IF 

simulate interrupt 
space 

squeeze 

store 

store multiple 
structure 

structure definition 
structure initialization 
symbol definition 

target 

test 

title 

unreferenced externals 

warning 

weak entry 

weak external 

width 

Integer constants 

address 

alignment of 

double precision 
floating point 
floating point 
fullword 

halfword 
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Integer constants 
(Cont inued) 
single precision 
floating point 


L 


LADC. See log of address 
length constant. 

Library files 

Line count instruction 

Linked list structure 

List conditional instruction 

List instruction 

List macro instruction 

List unreferenced symbols 
instruction 

Listing control instructions 

Listing identification 
instructions 

Load immediate instruction 

Load multiple instruction 

Load PSW instruction 

LOC. See location counter. 


Location counter instructions 


Log of address length 
constant 

Logical expressions 

Logical unit assignment 


M 


Machine instructions 
16-bit 
common assembly 
language/32 (CAL/32) 
Main memory 
accessing 
Memory addresses 
16-bit processors 
32-bit processors 
Message instruction 
Mixed expressions 
Mixed mode computations 
Mode 
absolute 
optimization 


relocatable 
Model 3200MPS System 
machine instructions and 
mnemonics for 
Multiprocessing system 
standard tasks 


N 


Name field 
characters 


symbols 


Nested conditionals 


No cross instruction 
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No freeze instruction 

No list conditionals 
instruction 

No List instruction 

No list macro instruction 

No list unreferenced symbols 
instruction 

No RX3 instruction 

No sequence check instruction 

No squeeze instruction 

No warning instruction 

NOCAL instruction 


O 


Offset counter 
Operand field 
Operation field 
Optimization process 
Origin instruction 
Origin statements 
Over lay 

path 


P 


Packed decimal string 
constant 
Pass pause instruction 
Pause instruction 
POSITION command 
Privileged system function 
Program instruction 
Program status word 
condition code 
location counter 
status descriptor 
Programming 
common mode 
Programs 
absolute 
relocatable 
Pseudo instructions 
APU 
NAPU 
PSF. See privileged system 
function. 
PSW. See program status 
word. 
Pure instruction 
Pure segment 


Quantities 
absolute 
relocatable 


R 


Register and immediate 
instructions 
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Nh 
t 
NN 


we me ee me ee ee ee ee ee me me ee oe ee wee ee we we ee Se oe me oe ee ee ee me we ome ee ee ee ee ee ee ee Oe oe oe wm Be me me oe om me we we ew em we wm ee ee ee me ee we ee eer er ee wer ee ee ee 


Register and immediate 
instructions (16-bit) 
Register and immediate one 
instructions (32-bit) 
Register and immediate two 
instructions (32-bit) 
Register and indexed storage 
instruction (16-bit) 
Register and indexed 
instructions 
Register and indexed 
one instructions 
Register and indexed 
three instructions 
Register to register 
instructions 
Register to register 
instructions (16-bit) 


storage 
storage 


storage 


Ss 


Scratch instruction 
Sequence check instruction 
Sequence checking instruction 
Short form instructions 

16-bit 

32-bit 
Simple IF instruction 
Source input file 

last instruction in 
Source statements 

comment 

instruction 
Space instruction 
Space optimization 
Special circumstances bit 
Special instructions 
Squeeze instruction 
Squeeze related instructions 
Start options 

APU 

NAPU 
Store multiple instruction 
String processing 

instructions 


Structure definition 
instructions 
Structure initialization 
instruction 
Structure instruction 
Subroutines 
branching to 
returning from 
Symbol definition 
data definition 
define constant 
define storage 
include 
Symbol definition instruction 
Symbols 
character 
decimal 
externally referenced 
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global 2-3 
hexadecimal 2-3 
implicit 2-3 
Symbols and expressions 2-1 


U,V 


Unpacked decimal string 


i 
i 
i 
i 
System architecture H constant 3-44 
multiprocessing 1-1 i Unreferenced externals 
uniprocessing 1-1 { instructions 3-62 
{| Unreferenced symbols 3-75 
i] 
t 
T i 
H W-Z 
Target machine code 4-1 i 
Task establishment 5-7 i Warning instruction 3-75 
Temporary storage | Weak entry instruction 3-28 
types of i=3 ;| Weak entry points 3-29 
Title instruction 3-72 {| Weak external instruction 3-28 
{ Width instruction 3-73 
4 
t 


48-050 FOO ROL IND-5 


LINE 


ALONG 


CUT 


Ce cemermemectiicecenceensns ti cree I en ee 
——oe ee eee ren eee ee me ee er ee ee 


Please use this postage-paid form to make any comments, suggestions, criticisms, etc. concerning 


this publication. 


From 
Title 
Company 


Address 


FOLD 


Check the appropriate item. 
[| -rror Page No. 
[-] Addition Page No. 
[J Other Page No. 


Explanation: - 


PUBLICATION COMMENT FORM 


Date 


Publication Title 


Publication Number 


paneer aareenenee erent mtn a nner a 


Drawing No. 
Drawing No. 


Drawing No. 


Fold and Staple 
No postage necessary if mailed in U.S.A. 


FOLD 


FOLD 


STAPLE 


"BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO. 22 OCEANPOAT, N.J. 


POSTAGE WILL BE PAID BY ADDRESSEE 


PERKIN-ELMER 


Computer Systems Division 
2 Crescent Place 
Oceanport, NJ 07757 


TECH PUBLICATIONS DEPT. MS 322A 


STAPLE 


STAPLE 


NO POSTAGE 
NECESSARY 
iF MAILED 


IN THE 
UNITED STATES 


STAPLE 


